Entegrasyon
Pazaryeri API bağlantı bilgileri, API kullanıcısı açma, secret gösterme ve silme, dört dilde örnek istekler.
Entegrasyon ekranı, kendi sisteminizi (ERP, entegratör yazılımı ya da kendi geliştirdiğiniz bir uygulama) pazaryeri API'sine bağlamak için gereken her şeyi bir arada sunar: API adresi, satıcı numaranız, API kullanıcılarınızın anahtar ve secret bilgileri, API dokümanları ve dört programlama dilinde hazır örnek istekler. Ürünlerinizi ve siparişlerinizi paneli kullanmadan otomatik aktarmak isteyen satıcılar ve onların yazılım ekipleri bu ekranı kullanır.
Ekrana ulaşma
Sol menüde Satıcı Paneli › Destek › Entegrasyon öğesini seçin.
Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur. Hesabınız bir satıcıya bağlı değilse ekran "Entegrasyon satıcı hesaplarına özeldir" uyarısını gösterir; API kullanıcıları yalnızca satıcı hesabıyla yönetilir.
Ekranın bölümleri
- Başlık — Entegrasyon ve altında Pazaryeri API'sine bağlanmak için API kullanıcılarınız, bağlantı bilgileri ve örnek istekler. açıklaması.
- Bağlantı bilgileri kartı — API adresi, satıcı numaranız ve kimlik doğrulama yöntemi.
- Dokümantasyon kartı — API dokümanlarına bağlantılar.
- API kullanıcıları (N/N) kartı — Açtığınız API kullanıcılarının listesi ve yönetim düğmeleri.
- Örnek istekler kartı — Seçtiğiniz istek ve dile göre kopyalanabilir kod örneği.
Bağlantı bilgileri
| Alan | Anlamı |
|---|---|
| API adresi | Entegrasyonunuzun istek göndereceği pazaryeri API'sinin temel adresi. Yanındaki Kopyala simgesiyle panoya alınır. Adres tanımlı değilse Bu kurulum için API adresi tanımlı değil; destek ekibinden isteyin. yazar. |
| Satıcı no | Satıcı hesabınızın numarası. Kopyala simgesiyle panoya alınır. |
| Kimlik doğrulama | API'nin kullandığı yöntem: Basic Auth: Authorization başlığına "Basic " + base64(API anahtarı:API secret) yazın. Yani her istekte API anahtarı ile secret'ı iki nokta üst üsteyle birleştirip base64'e çevirir ve Authorization başlığına koyarsınız. |
Kopyalama başarılı olunca Kopyalandı bildirimi çıkar; tarayıcı panoya yazmaya izin vermezse Bir şeyler ters gitti bildirimi çıkar.
Dokümantasyon
Dokümantasyon kartında Uçların tamamı, alanlar ve hata kodları API dokümanında. yazar. Kartta şu düğmeler bulunur (her biri yeni sekmede açılır):
- Türkçe doküman ve İngilizce doküman — API dokümanının PDF sürümleri. Kurulumunuzda doküman tanımlı değilse bu düğmeler görünmez.
- docs.hebiar.com — Çevrim içi dokümantasyon sitesi.
API kullanıcıları
Kartın başlığında kaç API kullanıcınız olduğu ve en fazla kaç tane açılabileceği yazar (ör. "API kullanıcıları (2/5)"). En fazla 5 API kullanıcısı açabilirsiniz. Başlığın altındaki not: Her entegrasyon (ERP, entegratör) için ayrı kullanıcı açmanız önerilir; biri sızarsa yalnız onu silersiniz.
Her satırda şunlar görünür:
| Alan | Anlamı |
|---|---|
| API anahtarı | Kullanıcının anahtarı (kullanıcı adı yerine geçer). Yanındaki Kopyala simgesiyle panoya alınır. |
| API secret | Kullanıcının gizli anahtarı. Listede güvenlik için yalnızca son dört karakteri görünür (ör. •••• a1b2); tamamı yalnızca Secret'ı göster ile açılır. |
| Tedarikçi no | API isteklerinin adresinde kullanılan tedarikçi numarası. Yalnızca tanımlıysa görünür. |
Henüz kullanıcı açmadıysanız kartta Henüz API kullanıcınız yok ve Entegrasyona başlamak için yeni bir API kullanıcısı oluşturun. yazar.
Yönetim işlemleri (yeni kullanıcı, secret gösterme, silme) ayrı bir yetki ister. Hesabınızda bu yetki yoksa Yeni API kullanıcısı, Secret'ı göster ve silme simgeleri görünmez; bilgileri yalnızca okuyabilirsiniz.
İşlemler
Yeni API kullanıcısı oluşturma
Yeni bir entegrasyon kuracağınızda ya da sızdığından şüphelendiğiniz bir anahtarı değiştireceğinizde kullanın.
- "API kullanıcıları" kartında Yeni API kullanıcısı düğmesine basın.
- Açılan pencerede "Yeni bir API anahtarı ve secret üretilecek. En fazla 5 kullanıcı açılabilir. Secret yalnız bir kez gösterilir." uyarısını okuyun.
- Oluştur düğmesine basın.
- API kullanıcısı oluşturuldu penceresinde yeni kullanıcının API anahtarı ve API secret bilgileri görünür. Her birini Kopyala simgesiyle alıp güvenli bir yere (ör. şifre yöneticisi) kaydedin.
- Kaydettim düğmesine basarak pencereyi kapatın.
Pencerede Secret'ı şimdi güvenli bir yere kaydedin. Kimseyle e-posta veya mesajla paylaşmayın. uyarısı yer alır. Yeni kullanıcı listeye eklenir. Onay metni secret'ın yalnız bir kez gösterileceğini söylese de, yönetim yetkiniz olduğu sürece secret'ı daha sonra listeden Secret'ı göster ile yeniden görüntüleyebilirsiniz; yine de secret'ı bu pencerede kaydetmeniz en güvenli yoldur. Bazı durumlarda secret bu pencerede gösterilemez; o zaman API kullanıcısı oluşturuldu; secret'ı listeden görüntüleyebilirsiniz. bildirimi çıkar ve secret'ı listeden Secret'ı göster ile alırsınız.
5 kullanıcıya ulaştığınızda Yeni API kullanıcısı düğmesi pasif olur; üzerine gelince "En fazla 5 API kullanıcısı açılabilir; yenisi için birini silin." yazar. Oluşturma başarısız olursa pencerede kırmızı hata kutusu çıkar (ör. API kullanıcısı oluşturulamadı.).
Secret'ı gösterme ve kopyalama
- Listede ilgili kullanıcının API secret alanının yanındaki göz simgesine (Secret'ı göster) basın.
- Secret'ın tamamı görünür ve yanında Kopyala simgesi belirir.
- İşiniz bitince Gizle simgesiyle secret'ı kapatabilirsiniz.
Gösterilen secret 60 saniye sonra kendiliğinden gizlenir; kartın altında "Gösterilen secret 60 saniye sonra kendiliğinden gizlenir." notu çıkar. Birden fazla kullanıcının secret'ını açtıysanız hepsi, son göster/gizle işleminizden 60 saniye sonra birlikte gizlenir. Secret getirilemezse ekranda kırmızı bir hata bildirimi çıkar. Secret'ı ekran paylaşımı yaparken ya da başkalarının görebileceği bir ortamda göstermeyin.
API kullanıcısını silme
Kullanılmayan ya da güvenliği şüpheli bir anahtarı iptal etmek için kullanın.
- Satırın sağındaki çöp kutusu simgesine (API kullanıcısını sil) basın.
- Açılan pencerede … silinecek. Bu anahtarı kullanan entegrasyonlar hemen çalışmayı durdurur. uyarısını okuyun.
- Sil düğmesine basın.
Silinince API kullanıcısı silindi bildirimi çıkar ve liste yenilenir. Silme geri alınamaz; bu anahtarı kullanan entegrasyonun yeni bir kullanıcıyla yeniden yapılandırılması gerekir. Silmeden önce yeni kullanıcıyı açıp entegrasyonu ona geçirmeniz kesintiyi önler. Silme başarısız olursa pencerede API kullanıcısı silinemedi. gibi bir hata çıkar.
Örnek istek alma
Örnek istekler kartı entegrasyonunuzu hızla denemeniz için hazır kod üretir (Postman'e ya da kodunuza kopyalayın. Varsayılan olarak yer tutucularla gelir.).
- Sağ üstteki dil seçiminden cURL, JavaScript, C# ya da Python'u seçin.
- İstek listesinden bir istek seçin:
- Ürün kaydetme — Ürün göndermek için örnek bir ürün gövdesiyle istek.
- Batch sorgulama — Gönderdiğiniz ürün paketinin işlenme durumunu sorgulama.
- Sipariş paketi çekme — Sipariş paketlerinizi çekme.
- Birden fazla API kullanıcınız varsa ikinci listeden örnekte kullanılacak API anahtarını seçin.
- Kodun sağ üstündeki Kopyala düğmesiyle örneği panoya alın.
Örnekte API adresi ve seçili kullanıcının tedarikçi numarası dolu gelir; kimlik bilgileri ise yer tutucu olarak görünür (ör. {BASE64(API_KEY:API_SECRET)}). Batch sorgulama örneğindeki {BATCH_ID} gibi yer tutucuları kendi değerlerinizle değiştirin; alanların ayrıntısı API dokümanındadır. API adresi ya da tedarikçi numarası tanımlı değilse bunların yerinde de {BASE_URL} ve {SUPPLIER_ID} yer tutucuları görünür.
Gerçek bilgilerimle doldur kutusu, örneğe seçili kullanıcının gerçek anahtar ve secret'ını yerleştirir:
- Kutuyu işaretleyebilmek için önce o kullanıcının secret'ını Secret'ı göster ile açmalısınız. Secret gösterilmemişse kutunun yanında Gerçek bilgilerle doldurmak için önce secret'ı gösterin yazar ve kutu pasiftir.
- Kutu işaretliyken örneğin yanında Örnek canlı kimlik bilgisi içeriyor uyarısı görünür. Bu örneği paylaşmayın, destek taleplerine ya da e-postaya yapıştırmayın.
- Secret 60 saniye sonra gizlendiğinde örnek yeniden yer tutuculara döner.
Sık karşılaşılan durumlar
- API adresi yerine "Bu kurulum için API adresi tanımlı değil" yazıyor. Pazaryeri API adresi sizin için henüz tanımlanmamıştır. Destek taleplerim ekranından işletmeciye talep açın.
- "Yeni API kullanıcısı" düğmesi pasif. 5 kullanıcı sınırına ulaştınız. Kullanmadığınız bir kullanıcıyı silip yeniden deneyin.
- Yeni API kullanıcısı, göster ve sil düğmeleri hiç yok. Hesabınızın API kullanıcılarını yönetme yetkisi yoktur; bilgileri yalnızca görebilirsiniz.
- Secret'ı kaydetmeyi unuttum. Yönetim yetkiniz varsa listeden Secret'ı göster ile yeniden görüntüleyip kopyalayabilirsiniz.
- Entegrasyonum birden çalışmayı durdurdu. Kullandığı API kullanıcısı silinmiş olabilir; silinen anahtarı kullanan entegrasyonlar hemen durur. Listede anahtarın hâlâ bulunduğunu kontrol edin; yoksa yeni kullanıcı oluşturup entegrasyonu güncelleyin.
- Ekran açılmıyor, hata kutusu çıkıyor. Tekrar dene'ye basın. Sorun sürerse Teknik ayrıntı bölümündeki metni destek ekibiyle paylaşın.
İlgili ekranlar
- Ürünlerim — API ile gönderdiğiniz ürünleri panelden izleyin.
- Toplu ürün işlemleri — API yerine Excel ile toplu ürün ve stok aktarımı.
- Siparişlerim — API ile çektiğiniz sipariş paketlerinin panel görünümü.
- Destek taleplerim — Entegrasyonla ilgili sorularınızı işletmeciye iletin.