Zonos Dashboard'unuza giriş yapın ve Hesap →
Entegrasyonlar seçeneğine gidin. Tablo iki anahtarı gösterir:
Dashboard'da Ad↕
Amaç↕
API için Kullanılsın mı?↕
Hesap anahtarı
Posta operatörü ile bağlantı kurma tanımlayıcısı
❌ HAYIR
API anahtarı
Zonos API'si çağrıları için kimlik doğrulama anahtarı
✅ EVET — bunu kullanın
API anahtarı satırındaki belirteci kopyalayın. credential_live_ ile başlar. Bu anahtara her iki entegrasyon yöntemi için de ihtiyacınız olacak.
API anahtarınızı güvenli tutun. Kaynak kontrolüne eklemeyin veya herkese açık şekilde paylaşmayın. Güvenliğinin ihlal edildiğini düşünüyorsanız, aynı Hesap → Entegrasyonlar sayfasından yeniden oluşturun.
Zonos Dashboard'unuzdaki Item Quoter aracı, sevkiyat yapmadan önce ürünlerinizin tahmini gümrük maliyetlerini aramanıza izin verir — oranları kontrol etmek ve Beyan Kimliği oluşturmadan önceden planlama yapmak için kullanışlıdır.
Teknik kurulumunuza uygun yöntemi seçin. Her iki yöntem de Česká pošta'nın sevkiyat sistemine yüklemeniz gereken Beyan Kimliklerini üretir.
Zonos'u doğrudan kendi sistemlerinden çağıran teknik müşteriler ve geliştiriciler için.
Bitiş Noktası
URL: https://api.zonos.com/graphql
Yöntem: POST
İçerik Türü: application/json
Kimlik Doğrulama
API anahtarınızı credentialToken başlığında geçirin:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API Örneği
Tam API örneği de dahil olmak üzere tam istek ve yanıt için Česká pošta hesabınıza giriş yapın.
Beyan Kimliklerini Oluşturduktan Sonra
Beyan Kimliğini Česká pošta'ya sevkiyat ayrıntılarınızla birlikte gönderin. Česká pošta, Beyan Kimliğini sevkiyatla bağlantılandırır ve bir takip numarası döndürür. Zonos, takip numaraları vermez.
Hata İşleme
Hata / Belirtisi↕
Olası neden ve çözüm↕
Güvenlik gereksinimi başarısız
API anahtarınız geçersiz veya yanlış başlıkta iletildi. API Anahtarını (Hesap Anahtarını değil) kullandığınızdan ve başlık adının credentialToken olduğundan emin olun.
HTTP 401 Yetkisiz
API anahtarı istek başlıklarında eksiktir. credentialToken dahil olduğunu doğrulayın.
Yanıtta errors dizisi
Mutation bir GraphQL hatası döndürdü. Ayrıntılar için hata dizisinde message alanını kontrol edin.
Beklenmeyen yanıt şekli
Yanıt data.declarationCreate.id içermedi. Tam yanıt gövdesini kaydedin ve mutation metninin örnekle tam olarak eşleştiğini doğrulayın.
Hesap Kurulumu
Hesap Kurulumu
Doğrulanmış Hesabınızı oluşturun, bir ödeme yöntemi ekleyin ve entegrasyonunuzu bağlayın.
Adım 1 — Doğrulanmış Hesabınızı Oluşturun
Česká pošta kayıt bağlantısını kullanarak Zonos Doğrulanmış Hesabına kaydolun. İş adresinizi ve faturalandırma kurulumunu tamamlayın.
Adım 2 — Ödeme Yöntemi Ekleyin
ABD'ye gönderilen kargolar için gümrük vergisi ödemelerini finanse etmek amacıyla Zonos hesabınıza bir ödeme yöntemi ekleyin.
Adım 3 — API Anahtarınızı Alın
Zonos Dashboard'unuza giriş yapın ve Hesap → Entegrasyonlar seçeneğine gidin. Tablo iki anahtarı gösterir:
API anahtarı satırındaki belirteci kopyalayın.
credential_live_ile başlar. Bu anahtara her iki entegrasyon yöntemi için de ihtiyacınız olacak.API anahtarınızı güvenli tutun. Kaynak kontrolüne eklemeyin veya herkese açık şekilde paylaşmayın. Güvenliğinin ihlal edildiğini düşünüyorsanız, aynı Hesap → Entegrasyonlar sayfasından yeniden oluşturun.
Adım 4 (isteğe bağlı) — Item Quoter ile Gümrük Maliyetlerini Tahmin Edin
Zonos Dashboard'unuzdaki Item Quoter aracı, sevkiyat yapmadan önce ürünlerinizin tahmini gümrük maliyetlerini aramanıza izin verir — oranları kontrol etmek ve Beyan Kimliği oluşturmadan önceden planlama yapmak için kullanışlıdır.
Entegrasyon Yöntemleri
Teknik kurulumunuza uygun yöntemi seçin. Her iki yöntem de Česká pošta'nın sevkiyat sistemine yüklemeniz gereken Beyan Kimliklerini üretir.
Zonos'u doğrudan kendi sistemlerinden çağıran teknik müşteriler ve geliştiriciler için.
Bitiş Noktası
https://api.zonos.com/graphqlapplication/jsonKimlik Doğrulama
API anahtarınızı
credentialTokenbaşlığında geçirin:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxAPI Örneği
Tam API örneği de dahil olmak üzere tam istek ve yanıt için Česká pošta hesabınıza giriş yapın.
Beyan Kimliklerini Oluşturduktan Sonra
Beyan Kimliğini Česká pošta'ya sevkiyat ayrıntılarınızla birlikte gönderin. Česká pošta, Beyan Kimliğini sevkiyatla bağlantılandırır ve bir takip numarası döndürür. Zonos, takip numaraları vermez.
Hata İşleme
credentialTokenolduğundan emin olun.credentialTokendahil olduğunu doğrulayın.errorsdizisimessagealanını kontrol edin.data.declarationCreate.idiçermedi. Tam yanıt gövdesini kaydedin ve mutation metninin örnekle tam olarak eşleştiğini doğrulayın.Bu sayfa faydalı mıydı?