Şu anda açıklanan arayüz alanları
Bunlar yetenek alanlarıdır, koşulsuz olarak kullanılabilir bir uç nokta listesi değildir. Adlar, alanlar, durumlar ve ortamlar, erişim incelemesinden sonra sağlanan onaylı belgelere uygundur.
Navlun fiyatı arama
Halihazırda iş sistemi tarafından sağlanan yapılandırılmış seçenekleri almak için kalkış, varış yeri, kargo, ağırlık, boyutlar ve hizmet gereksinimlerini gönderin. Arayan kişi toplam ücretleri icat etmemeli veya yeniden yazmamalıdır. Kullanılabilirlik, onaylı entegrasyona bağlıdır.
Yetkili gönderi takibi
Kaynak ve son güncellenen bilgileri içeren iş durumu kodlarını kullanarak yalnızca arayanın erişim yetkisine sahip olduğu siparişler veya gönderiler için takip alın. Kullanılabilirlik, onaylı entegrasyona bağlıdır.
Uygulamalar ve destek koordinasyonu
Hizmet sağlayıcı, tanıtım ortaklığı ve API erişim başvuruları ile destek talepleri için kontrollü gönderim ve durum koordinasyonu değerlendirilebilir.
Onaylanan AI aracı çağrıları
Bir AI asistanı, yetkilendirme kontrolleri ve denetim kontrolleri ile yalnızca izin verilenler listesindeki arayüzleri arayabilir. Model çıktısı, API sonuçlarının veya insan incelemesinin yerini alamaz. Kullanılabilirlik, onaylı entegrasyona bağlıdır.
Uygun kullanıcılar ve uygulama bilgileri
Toplu sorgular, dahili iş akışı entegrasyonu veya yetkili veri koordinasyonunu içeren kurumsal kullanım durumları için uygundur. Başvurular şirket ve iletişim bilgilerini, kullanım senaryosunu, ana hatları, kargo türlerini, amaçlanan çağrı modelini, gerekli kapasiteyi, teknik iletişim ve güvenlik gereksinimlerini içermelidir. Başvuru sahibi, gerçek iş ihtiyaçlarından çağrı hacmini ve sıklığını sağlamalıdır.
Uygulamadan üretime
Katılım normalde gereksinimlerin onaylanmasını, varlık ve erişim incelemesini, teknik değerlendirmeyi, test ve doğrulamayı, güvenlik kontrollerini, anlaşma onayını ve üretim onayını içerir. Başvuru otomatik olarak uç nokta, korumalı alan veya üretim erişimi sağlamaz.
API sözleşmesi ve veri kuralları
Onaylı dokümantasyon; sürümlemeyi, kimlik doğrulamayı, alanları, birimleri, para birimini, saat dilimini, dili, istek kimliklerini, idempotentliği, istek hızı sınırlarını, zaman aşımlarını, hata kodlarını ve değişiklik politikasını tanımlamalıdır. Ücretler, API’nin döndürdüğü para birimini, geçerlilik süresini ve dökümü korumalıdır; bilinmeyen değerler teyit bekliyor olarak işaretlenmeli, sıfır veya ücretsiz olarak gösterilmemelidir.
Kimlik bilgileri, yetkilendirme ve veri güvenliği
API anahtarları ve erişim belirteçleri kontrollü bir sunucu ortamında tutulmalı; tarayıcı veya mobil uygulama kodunda, herkese açık depolarda ya da görünür günlüklerde yer almamalıdır. Her çağrı istekte bulunanın kimliğini doğrulamalı ve yetkisini denetlemeli; en az ayrıcalık ilkesini, istek hızı sınırlarını, denetim kontrollerini ve gerekli veri maskelemeyi uygulamalıdır.
Planlanan yetenekler nasıl tanımlanıyor?
Sipariş oluşturma, etiketler, faturalandırma, mutabakat ve Web kancaları yalnızca uç noktalar, izinler, imza veya tekrar oynatma koruması, hata işleme, testler ve onaylı belgeler tamamlandıktan sonra kullanılabilir olarak tanımlanabilir. O zamana kadar bunlar kullanılabilirlik taahhütleri değildir.