Ana içeriğe atla
İki anahtar. Birini saklarsınız, diğerini her saat atıp yenisini alırsınız.

Refresh anahtarınızı alın

Panelde Ayarlar → API Integrations bölümüne gidin ve Connect’e basın. Bu işlem refresh_token değerinizi oluşturur. Bu anahtar kalıcıdır ve elinizdeki tek uzun ömürlü kimlik bilgisidir. Belirteç uç noktası dışında hiçbir şeyi çağırmak için kullanılamaz.
Refresh anahtarını bir şifre gibi koruyunSüresi dolmadığı için sızdırılan bir anahtar, biri fark edip yeniden oluşturana kadar onu ele geçiren kişi için kullanılabilir olmaya devam eder.Yeri bir gizli bilgi yöneticisi (secrets manager) ya da bir ortam değişkenidir; asla istemci tarafı kod, mobil uygulama paketi, kod deposu, destek bileti veya ekran görüntüsü değildir. Bir tarayıcıya ulaşan her şey, o tarayıcıyı kullanan kişi tarafından okunabilir.

Erişim belirteciyle değiştirin

POST /rest/v2/refreshToken Free+
Yanıt, geçerlilik süresi bir saat olan bir access_token içerir. Bunu diğer tüm çağrılarda gönderin:
Erişim belirtecini önbelleğe alın; her istek için yenisini istemeyinBir belirteç bir saat geçerlidir; dolayısıyla o saat içinde API’yi bin kez çağıran bir iş için bin değil, tek bir belirteç yeterlidir.Sağlam yöntem şudur: Belirteci ve bitiş zamanını bellekte tutun, süresinin dolmasına birkaç dakika kala yenileyin ve sizin saatinizle sunucunun saatinin uyuştuğunu varsaymak yerine 401 yanıtı aldığınızda da yenileyin. Her çağrı için yeni belirteç istemek, bir entegrasyonun yavaşlamasının en yaygın nedenidir.

Bağlantıyı kontrol edin

GET /rest/v2/healthCheck Free+ Platformun erişilebilir olduğunu ve yanıt verdiğini doğrular. Kendi izleme sisteminize bağlamanıza değer; böylece bir şey bozulduğunda hangi tarafta bozulduğunu zaten bilirsiniz.

Test ortamı (sandbox)

Kendi hesabı, kendi anahtarı ve test kargo şirketleri olan ayrı bir ortamdır: https://staging-api.tryoto.com. Aynı yollar, aynı veri yapıları.
Test ortamında geliştirin, ancak geçişi de test edinTest ortamı, gerçek koliye dönüşmeyen siparişler ve gerçek faturaya dönüşmeyen rezervasyonlar oluşturduğunuz yerdir. Üzerinde güvenle deneme yapabileceğiniz başka bir ortam yoktur.Asıl hazırlıklı olmanız gereken an, canlıya geçiştir: Canlı ortamda kargo şirketi sözleşmeleri, hub’lar ve kodlar farklıdır. Geliştirme sırasında koda gömülen bir yapılandırma değeri, canlıya geçişin ilk günündeki klasik sorundur; bu yüzden ortama özgü her değeri ilk commit’ten itibaren yapılandırmada tutun.

Planlara göre erişim

Uç noktalar abonelik planlarına göre sınırlandırılır; bazıları ayrıca bir ek modül gerektirir. Dizindeki her uç noktada, onu içeren en düşük plan belirtilir.
API üzerinden mağazadan gönderim, Kurumsal Plan özelliğidirÇıkış noktaları tüm planlarda oluşturulabilir, ancak yalnızca depo olarak. type: "branch" türünde, yani aynı zamanda gönderim de yapan bir mağaza oluşturmak yalnızca Kurumsal Plan’da mümkündür.Mağazaların siparişleri programatik olarak hazırlamasını planlıyorsanız, tasarımınızı buna göre kurmadan önce kontrol etmeniz gereken sınır budur. Şubenin ne olduğunu ve neden önemli olduğunu öğrenmek için Hub Yönetimi sayfasına bakın.

İlgili sayfalar