Ana içeriğe atla
Bir API’yi anlamanın en hızlı yolu onu çağırmaktır. Yayımlanan koleksiyon, daha kendi kodunuzun tek satırını yazmadan bunu test ortamında yapmanızı sağlar.

​
Koleksiyon

Tüm başvuru kaynağı apis.tryoto.com adresindedir. Doğrudan Postman koleksiyonunun kendisinden üretilir, bu yüzden API’den kopmaz: Her uç nokta gerçek istek gövdesini, canlı bir örnek yanıtı ve otuzdan fazla dilde çalıştırılabilir kodu içerir.

​
Test ortamında çalışmak

Koleksiyonu https://staging-api.tryoto.com adresine yönlendirdiğinizde, gerçek kargo şirketleri yerine test kargo şirketleriyle, tam olarak canlı ortamdaki gibi davranır. Aynı yollar, aynı yükler, aynı yanıtlar; ancak gerçek koli ve fatura yok.
Temel URL’yi ilk günden bir değişken olarak tanımlayınTest ortamı ile canlı ortam arasındaki tek fark, sunucu adresi ve anahtardır. İkisi de baştan koleksiyon değişkeni olursa, ortam değiştirmek bir açılır menüden seçim yapmaktan ibarettir.Bunun yerine her isteğe elle yazılırlarsa, ortam değiştirmek her isteği düzenlemek ve birini atlamak anlamına gelir. Atlanan da genellikle bir şey oluşturan istek olur.

​
On dakikalık ilk deneme

  1. Bir test ortamı hesabı edinin ve bu hesabın refresh_token değerini Ayarlar → API Integrations bölümünden alın.
  2. POST /rest/v2/refreshToken uç noktasını çağırın. access_token değerini bir değişkene kaydedin.
  3. Hem anahtarın hem de sunucu adresinin doğru olduğunu doğrulamak için GET /rest/v2/healthCheck uç noktasını çağırın.
  4. Adresi test kargo şirketlerinizin hizmet verdiği bir yerle değiştirerek, örnek gövdeyle POST /rest/v2/createOrder uç noktasını çağırın.
  5. Bu güzergah için POST /rest/v2/checkOTODeliveryFee uç noktasını çağırın ve dönen sonuca bakın: kargo şirketi bazında fiyatlar, tahmini teslimat süreleri ve son kabul saatleri.
  6. POST /rest/v2/createShipment uç noktasını çağırın. Artık yazdırabileceğiniz bir kargo etiketiniz (AWB) var.
Bu sıralama, entegrasyonun tamamının küçük bir modelidir. Geri kalan her şey bunun bir varyasyonudur.
Test ortamında gerçek bir adres kullanınKargo şirketi kapsama alanı test ortamında bile kontrol edilir; bu yüzden uydurma bir şehir “no carriers available” sonucunu verir ve kötü bir test verisi yerine bozuk bir entegrasyon gibi görünür.availableCities yanıtında gördüğünüz bir şehri seçin ve onu kullanmaya devam edin.

​
İlgili sayfalar