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.
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)Yeni Ekle'ye tıklayın
Sol paneldeki ⊕ Yeni Ekle bağlantısı hesap formunu açar.
| Alan | Açıklama |
|---|---|
| İsim Zorunlu | Bağlantının ne için olduğunu anlatan ad (örn. "Bayi Sitesi", "Muhasebe Programı"). |
| IP | Yazarsanız API yalnızca bu adresten gelen istekleri kabul eder. Kısıtlama istemiyorsanız boş bırakın. |
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.
Hesap Ayarları: Neler Paylaşılsın?
Listede hesabın adına tıklayın. Düzenleme penceresinde dört sekme vardır:
| Sekme | Ne işe yarar |
|---|---|
| Genel | Hesabın adı ve IP kısıtlaması. |
| Markalar | Marka eklerseniz API yalnızca bu markaları ve ürünlerini paylaşır. Liste boşsa tüm markalar paylaşılır. |
| Kapalı Ürünler | Buraya eklenen ürünler bu hesapta hiç görünmez. |
| Kapalı Firmalar | Seçilen tedarikçilerin ürünleri bu hesaptan gizlenir. |
Ç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,markalarya dakategoriler. - Yanıt JSON olarak gelir; XML için adresin sonuna
?method=xmlekleyin.
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.