Etibas Yardım Merkezi

API Hesapları

Bayi sitenizin, muhasebe programınızın ya da kendi yazılımınızın Etibas'taki verilerinize güvenle ulaşması için API hesabı oluşturun.

API hesabı, başka bir yazılımın Etibas'taki ürün, stok, marka, kategori ve sipariş bilgilerinize ulaşmasını sağlar. Her hesabın kendine ait gizli bir token'ı vardır. Hesap bazında hangi adresten erişileceğini ve hangi markaların ya da ürünlerin paylaşılacağını siz belirlersiniz.

Videolu anlatım · Hesap açma, IP kısıtlaması, marka ve ürün paylaşımı, canlı örnek istek YouTube'da izle ↗
1

Api Hesapları ekranına gidin

Üst menüden AYARLAR menüsünü açın ve Api Hesapları'nı seçin. Listede her satır bir hesaptır: İsim, IP (boşsa her adresten erişilebilir) ve Token.

▶ Videoda göster (0:18)
2

Yeni Ekle'ye tıklayın

Sol paneldeki ⊕ Yeni Ekle bağlantısı hesap formunu açar.

AlanAçıklama
İsim ZorunluBağlantının ne için olduğunu anlatan ad (örn. "Bayi Sitesi", "Muhasebe Programı").
IPYazarsanız API yalnızca bu adresten gelen istekleri kabul eder. Kısıtlama istemiyorsanız boş bırakın.
▶ Videoda göster (1:03)
3

Gönder'e tıklayın

Gönder ile hesap kaydedilir; Etibas benzersiz bir token üretir ve listede gösterir. Bu token'ı bağlantıyı kuracak yazılıma girin.

💡
Her bağlantıya ayrı hesap Bayi siteniz, muhasebe programınız ve diğer yazılımlar için ayrı hesaplar açın. Böylece birini kapattığınızda diğerleri etkilenmez.

Hesap Ayarları: Neler Paylaşılsın?

Listede hesabın adına tıklayın. Düzenleme penceresinde dört sekme vardır:

SekmeNe işe yarar
GenelHesabın adı ve IP kısıtlaması.
MarkalarMarka eklerseniz API yalnızca bu markaları ve ürünlerini paylaşır. Liste boşsa tüm markalar paylaşılır.
Kapalı ÜrünlerBuraya eklenen ürünler bu hesapta hiç görünmez.
Kapalı FirmalarSeçilen tedarikçilerin ürünleri bu hesaptan gizlenir.
▶ Videoda göster (1:39)

Çok sayıda marka ya da ürün için sol paneldeki Excel ile Toplu İşlem bağlantısını kullanın: API Hesabına Marka Ekle ve API Hesabına Kapalı Ürün Ekle işlemleriyle her satıra hesap adı ve marka (ya da ürün) yazarak toplu ekleyebilirsiniz. Mevcut listeler korunur, üzerine eklenir.

▶ Videoda göster (2:30)

API'ye Bağlanma

Teknik rehber, ekranın sol panelindeki Api Dökümanı bağlantısındadır (api.etibas.com/dokumantasyon.php). Adres yapısı:

https://api.etibas.com/{hesap-no}/{token}/{bilgi}

  • hesap-no – Kullanıcı menüsündeki Abonelik / Profil ekranında Hesap No satırında yazar.
  • token – Api Hesapları listesindeki token.
  • bilgi – urunler, siparisler, markalar ya da kategoriler.
  • Yanıt JSON olarak gelir; XML için adresin sonuna ?method=xml ekleyin.
▶ Videoda göster (2:40) ▶ Canlı örnek istek (3:11)
⚠️
Token güvenliği Token, hesabın gizli anahtarıdır; yalnızca güvendiğiniz kişilerle paylaşın. Başkasının eline geçtiğinden şüphelenirseniz hesabı silip yeni bir hesap açın; eski token en geç bir dakika içinde geçersiz olur. Mümkünse IP kısıtlaması kullanın.
▶ Videoda göster (3:29)
Videonun yazılı metniAPI ile Ürün Paylaşımı: Token ve IP Kısıtlamalı API Hesabı | Etibas

0:00Giriş

Merhaba! Bu videoda Etibas'ta API hesabı oluşturmayı adım adım göreceğiz: token almayı, IP kısıtlamasını, API'nin hangi markaları ve ürünleri paylaşacağını belirlemeyi ve verilerinize API üzerinden ulaşmayı.

0:18Api Hesapları ekranına ulaşma

API hesabı, bayi sitenizin, muhasebe programınızın ya da kendi yazılımınızın Etibas'taki ürün, stok ve sipariş bilgilerinize güvenle ulaşmasını sağlar. Bu ekrana üst menüdeki Ayarlar menüsünden ulaşıyoruz. Ayarlar'ı açıp Api Hesapları'nı seçiyoruz.

0:36Hesap listesi: IP ve token

Listede her satır bir API hesabıdır. Her bağlantı için ayrı hesap açmanızı öneririz; böylece birini kapattığınızda diğerleri etkilenmez. IP sütunu, hesabın yalnızca hangi adresten kullanılabileceğini gösterir. Boşsa her adresten erişilebilir. Token, bu hesabın gizli anahtarıdır. Bağlanacak yazılım her istekte bu anahtarı kullanır; o yüzden onu yalnızca güvendiğiniz kişilerle paylaşın.

1:03Yeni API hesabı açma

Yeni bir hesap açmak için sol paneldeki Yeni Ekle bağlantısına tıklıyoruz. Zorunlu olan tek alan İsim. Bağlantının ne için olduğunu anlatan bir ad verin; biz Stok Takip Uygulaması yazıyoruz. IP alanına bir adres yazarsanız API yalnızca o adresten gelen istekleri kabul eder. Kısıtlama istemiyorsanız boş bırakın. Gönder'e bastığınızda Etibas bu hesap için benzersiz bir token üretir ve listede gösterir. Bu tanıtım hesabı salt okunur olduğu için biz kaydetmiyoruz.

1:39Hesap ayarları ve sekmeler

Bir hesabın ayarlarını değiştirmek için adına tıklayın. Marka Bayisi hesabını açıyoruz. Pencerede dört sekme var: Genel, Markalar, Kapalı Ürünler ve Kapalı Firmalar. Genel sekmesinde hesabın adını ve IP kısıtlamasını değiştirebilirsiniz.

1:59Paylaşılacak markalar, kapalı ürünler ve firmalar

Markalar sekmesine marka eklerseniz API yalnızca bu markaları ve bu markaların ürünlerini paylaşır. Liste boşsa tüm markalar paylaşılır. Bu örnekte bayi yalnızca iki markayı görüyor. Kapalı Ürünler sekmesine eklediğiniz ürünler bu hesapta hiç görünmez; örneğin yalnızca kendi mağazanızda satmak istediğiniz ürünler. Kapalı Firmalar sekmesinde seçtiğiniz tedarikçilerin ürünleri de bu hesaptan gizlenir.

2:30Excel ile toplu işlem

Çok sayıda marka ya da ürünü tek tek eklemek yerine, sol paneldeki Excel ile Toplu İşlem bağlantısından bir Excel dosyasıyla toplu ekleyebilirsiniz.

2:40API dokümanı ve adres yapısı

Bağlantıyı kuracak yazılımcınız için teknik rehber, sol paneldeki Api Dökümanı bağlantısındadır. Adres yapısı basittir: api.etibas.com, ardından hesap numaranız, token ve istediğiniz bilgi. Ürünler, siparişler, markalar ve kategoriler alınabilir; yanıt JSON ya da XML olarak gelir. Hesap numaranızı, kullanıcı menüsündeki Abonelik / Profil ekranında Hesap No satırında görürsünüz.

3:11Canlı örnek istek ve IP kısıtlaması

Şimdi tanıtım hesabındaki Bayi Sitesi token'ıyla markaları isteyelim. Etibas, markaları anında JSON olarak döndürüyor. IP kısıtlı muhasebe hesabının token'ını başka bir adresten denediğimizde ise istek reddediliyor. IP kısıtlaması tam olarak bunu sağlar.

3:29Token güvenliği

Bir token'ın başkasının eline geçtiğinden şüphelenirseniz o hesabı silip yeni bir hesap açın; eski token en geç bir dakika içinde geçersiz olur.

3:38Yardım dokümanına ulaşma

Bu ekranla ilgili yazılı rehbere her zaman sol paneldeki Nasıl Yapılır bağlantısından ulaşabilirsiniz. Etibas yardım sitesindeki API hesapları rehberinde adımları ve sık sorulan soruları bulursunuz.

3:53Özet

Özetle: Etibas'ta API hesapları Ayarlar menüsünden yönetilir. Her bağlantı için ayrı hesap açın, gerekiyorsa IP kısıtlaması koyun, paylaşılacak markaları ve kapalı ürünleri belirleyin, token'ı güvenle saklayın. Daha fazla rehber için yardim.etibas.com adresini ziyaret edebilirsiniz.


Sık Sorulan Sorular

Kaç API hesabı açabilirim?
Birden fazla açabilirsiniz. Her bağlantı için ayrı hesap açmanız, hangisinin neye eriştiğini yönetmenizi kolaylaştırır.

Token'ı değiştirebilir miyim?
Token düzenlenemez. Yeni bir token için hesabı silip aynı ayarlarla yeniden açın ve yeni token'ı bağlantı kuran yazılıma girin.

İstek "IP Tanımsız" hatası veriyor, neden?
Hesapta IP kısıtlaması vardır ve istek başka bir adresten gelmiştir. Doğru adresi hesabın Genel sekmesine yazın ya da kısıtlamayı kaldırmak için alanı boşaltın.

API bazı ürünlerimi göstermiyor, neden?
Hesabın Markalar sekmesinde marka varsa yalnızca o markalar paylaşılır. Ayrıca Kapalı Ürünler ve Kapalı Firmalar sekmelerini, ürünün pasif olup olmadığını kontrol edin.

←
→