Entegrasyonlar

Pazaryeri API'si için API kullanıcıları açın, secret'ları yönetin, bağlantı bilgilerini ve örnek istekleri alın.

Entegrasyonlar ekranı (sayfa başlığı Entegrasyon kullanıcıları), pazaryeri API'sine dışarıdan bağlanacak sistemler (ERP, entegratör yazılımı vb.) için API kullanıcılarını yönettiğiniz yerdir. Burada API anahtarı ve secret üretir, bağlantı adresi ile satıcı numaranızı kopyalar, API dokümanlarına ulaşır ve dört programlama dilinde hazır örnek istekleri alırsınız. Ekran, hesabınızın bağlı olduğu satıcı kimliği adına çalışır; entegrasyonu kuran yazılım ya da operasyon ekibine yöneliktir.

Ekrana ulaşma

Menüde Ayarlar & Yetki › Sistem › Entegrasyonlar yolunu izleyin. Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur.

Yeni API kullanıcısı, Secret'ı göster ve API kullanıcısını sil düğmeleri yalnızca entegrasyon kullanıcılarını yönetme yetkisi olan hesaplarda görünür. Görmüyorsanız bilgileri yalnızca görüntüleyebilirsiniz.

Ekranın bölümleri

Sayfa başlığının altında "Pazaryeri API'sine bağlanmak için API kullanıcılarınız, bağlantı bilgileri ve örnek istekler." açıklaması bulunur. Altında dört bölüm yer alır:

1. Bağlantı bilgileri: API adresi, satıcı numarası, kimlik doğrulama yöntemi ve ilk adımlar.
2. Dokümantasyon: API dokümanlarının bağlantıları.
3. API kullanıcıları (…/…): açılmış API kullanıcılarının listesi ve yönetim düğmeleri.
4. Örnek istekler: kopyalanabilir kod örnekleri.

Hesabınız bir satıcı kimliğine bağlı değilse bu bölümler yerine bilgilendirme kartı görünür (bkz. Sık karşılaşılan durumlar).

Bağlantı bilgileri

Kartın altındaki adımlar entegrasyonun kısa özetidir:

1. "API kullanıcısı oluştur" ile bir kullanıcı açın (en fazla 5).
2. İsteklerde Authorization başlığına Basic anahtar:secret (Base64) ekleyin.
3. Aşağıdaki örnekleri kopyalayıp Postman ya da kodunuzda deneyin.

Kopyalama başarılı olunca Kopyalandı bildirimi görünür.

Dokümantasyon

"Uçların tamamı, alanlar ve hata kodları API dokümanında." notunun altında şu düğmeler bulunur; her biri yeni sekmede açılır:

• Türkçe doküman ve İngilizce doküman: kurulumunuz için doküman dosyası tanımlıysa görünür.
• docs.hebiar.com: genel API doküman sitesi.

API kullanıcıları

Bölüm başlığı açık kullanıcı sayısını ve üst sınırı gösterir (ör. API kullanıcıları (2/5)). 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:

Henüz kullanıcı yoksa "Henüz API kullanıcınız yok" ve "Entegrasyona başlamak için yeni bir API kullanıcısı oluşturun." yazar.

İşlemler

Yeni API kullanıcısı oluşturma

1. API kullanıcıları bölümündeki Yeni API kullanıcısı düğmesine basın.
2. Onay kutusundaki bilgiyi okuyun: "Yeni bir API anahtarı ve secret üretilecek. En fazla 5 kullanıcı açılabilir. Secret yalnız bir kez gösterilir."
3. Oluştur'a basın.
4. API kullanıcısı oluşturuldu kutusunda yeni API anahtarı ve API secret görünür. Her birini Kopyala simgesiyle alın ve güvenli bir yere kaydedin. Kutudaki uyarı: "Secret'ı şimdi güvenli bir yere kaydedin. Kimseyle e-posta veya mesajla paylaşmayın."
5. Kaydettim'e basarak kutuyu kapatın. Liste yenilenir.

Sunucu secret'ı bu adımda döndürmezse kutu açılmaz; bunun yerine "API kullanıcısı oluşturuldu; secret'ı listeden görüntüleyebilirsiniz." bildirimi görünür.

Beş kullanıcı açılmışsa düğme pasiftir; üzerine geldiğinizde "En fazla 5 API kullanıcısı açılabilir; yenisi için birini silin." yazar. Oluşturma başarısız olursa onay kutusu kapanmaz ve hata kutunun içinde gösterilir; işlem sürerken Oluştur düğmesinde Kaydediliyor… yazar.

Secret'ı gösterme ve gizleme

1. İlgili satırda API secret yanındaki göz simgesine (Secret'ı göster) basın.
2. Secret'ın tam değeri görünür ve yanında Kopyala simgesi belirir.
3. Tekrar gizlemek için aynı yerdeki Gizle simgesine basın.

Açık bırakılan secret'lar yaklaşık 60 saniye sonra kendiliğinden gizlenir; listenin altında "Gösterilen secret 60 saniye sonra kendiliğinden gizlenir." notu görünür. Birden fazla secret açtıysanız süre son açtığınızdan itibaren işler ve hepsi birlikte gizlenir. Secret alınamazsa ekranda hata bildirimi görünür.

API kullanıcısını silme

Bir anahtar artık kullanılmıyorsa ya da ele geçirildiğinden şüpheleniyorsanız silin.

1. Satırın sağındaki çöp kutusu simgesine (API kullanıcısını sil) basın.
2. Onay kutusundaki uyarıyı okuyun: "… silinecek. Bu anahtarı kullanan entegrasyonlar hemen çalışmayı durdurur."
3. Sil'e basın.

Silme başarılı olursa API kullanıcısı silindi bildirimi görünür ve liste yenilenir. Silme geri alınamaz; aynı entegrasyonu sürdürmek için yeni bir kullanıcı açıp yeni anahtarı entegrasyona tanımlamanız gerekir. Silme başarısız olursa hata onay kutusunda gösterilir.

Örnek istekler

"Postman'e ya da kodunuza kopyalayın. Varsayılan olarak yer tutucularla gelir."

Örnek kod varsayılan olarak {BASE_URL}, {SUPPLIER_ID}, {BATCH_ID} ve Basic {BASE64(API_KEY:API_SECRET)} gibi yer tutucular içerir. API adresi tanımlıysa ve seçili API kullanıcısının tedarikçi numarası varsa, bu ikisi kutuyu işaretlemeden de örneğe gerçek değerleriyle yazılır; yalnızca kimlik bilgisi (Authorization başlığı) aşağıdaki kutuyla doldurulur. Kodu sağ üstteki Kopyala düğmesiyle alırsınız.

Örneği gerçek bilgilerle doldurma

1. Önce API kullanıcıları bölümünde, örnekte seçili API anahtarına ait kullanıcının secret'ını Secret'ı göster ile açın.
2. Örnek istekler bölümünde Gerçek bilgilerimle doldur kutusunu işaretleyin.
3. Örnekteki Authorization başlığı gerçek anahtar ve secret ile doldurulur; yanında Örnek canlı kimlik bilgisi içeriyor uyarısı görünür.

Secret gösterilmemişse kutu pasiftir ve "Gerçek bilgilerle doldurmak için önce secret'ı gösterin" yazar. Secret kendiliğinden gizlendiğinde örnek yeniden yer tutuculara döner.

Gerçek bilgi içeren örnekleri e-posta, sohbet ya da destek kaydı gibi paylaşılan yerlere yapıştırmayın.

Sık karşılaşılan durumlar

• "Bu hesap bir satıcıya bağlı değil" yazıyor. API kullanıcıları satıcı kimliğine bağlı açılır. Oturumunuzda satıcı kimliği olmadığı için liste boştur ve yeni kullanıcı açılamaz. Bu durumda yalnızca kimlik doğrulama bilgisi, ilk adımlar ve (tanımlıysa) doküman düğmeleri görünür. Hesabınızın satıcıya bağlanması için sistem yöneticinize başvurun.
• Yeni API kullanıcısı düğmesi pasif. Beş kullanıcı sınırına ulaştınız. Kullanılmayan bir kullanıcıyı silip yeniden deneyin.
• Secret'ı kaydetmeyi unuttum. Secret'ı göster ile değeri yeniden görüntüleyebilirsiniz. Bu düğmeyi görmüyorsanız yetkisi olan bir kullanıcıdan yardım isteyin.
• Entegrasyon birden çalışmayı durdurdu. Kullandığı API kullanıcısı silinmiş olabilir. Listede anahtarın hâlâ bulunduğunu kontrol edin; yoksa yeni kullanıcı açıp entegrasyona tanımlayın.
• API adresi görünmüyor. "Bu kurulum için API adresi tanımlı değil; destek ekibinden isteyin." yazıyorsa adres kurulumunuzda henüz tanımlanmamıştır; destek ekibine başvurun.
• Ekranda "Bir şeyler ters gitti" yazıyor. Bilgiler yüklenemedi. Tekrar dene'ye basın; sorun sürerse Teknik ayrıntı bölümündeki metni sistem yöneticinize iletin.

İlgili ekranlar

• Entegrasyon (Satıcı paneli)
• API istemcileri
• Önbellek
• Mağaza ayarları