Endpoint, API'de "kapı numarası" gibidir. Her işlem ayrı bir adreste yapılır: ürün listelemek için bir uç, stok güncellemek için başka bir uç, sipariş çekmek için bir başkası. Yazılım doğru işi yapmak için doğru adrese doğru yöntemle istek gönderir.
Bir uç noktanın parçaları
Saystok'un Trendyol bağlantısında stok ve fiyat şu uca gönderilir:
| Parça | Değer | Anlamı |
|---|---|---|
| Yöntem | POST | Veri gönderilecek |
| Temel adres | https://apigw.trendyol.com | Trendyol'un canlı API ağ geçidi |
| Yol | /integration/inventory/sellers/{sellerId}/products/price-and-inventory | Stok ve fiyat güncelleme işlemi |
| Yol parametresi | {sellerId} | Satıcı ID'niz buraya yazılır |
Aynı uç noktaya farklı HTTP yöntemleriyle farklı işler yapılabilir. GET okur, POST oluşturur ya da işlem başlatır, PUT günceller, DELETE siler. Yöntemlerin anlamı RFC 9110 ile tanımlanır.
Tek adres değil, birden çok servis
Bazı pazaryerleri işleri farklı servis adreslerine böler. Hepsiburada'da fiyat ve stok Listing servisinde (listing-external.hepsiburada.com), katalog MPOP servisinde (mpop.hepsiburada.com), siparişler OMS servisinde (oms-external.hepsiburada.com) bulunur. Üçü aynı kimlik bilgileriyle çalışır. Ayrıntı: Hepsiburada servis adresleri.
Canlı ve test adresleri
Uç noktanın yolu genelde aynıdır, temel adres değişir. Trendyol'da canlı ortam https://apigw.trendyol.com, test ortamı https://stageapigw.trendyol.com adresindedir. Yazılımda temel adresi ayarlardan değiştirilebilir tutmak, test ile canlı arasında geçişi kolaylaştırır. Bkz. sandbox.
Uç nokta değişirse
Platformlar zaman zaman adresleri taşır ve eski uçları kapatır. Bu tür değişiklikler geliştirici sitelerindeki değişiklik notlarında duyurulur. Entegrasyon yazılımı kullanıyorsanız bu takibi yazılım sağlayıcısı yapar; kendi yazılımınızsa duyuruları izleyin.
Sık hatalar
- 404 Not Found: Yol yanlış yazıldı ya da uç kapatıldı.
- 405 Method Not Allowed: Doğru adrese yanlış yöntemle gidildi.
- Yol parametresine satıcı ID yerine başka bir değer yazıldı.
- Test ortamı adresi ile canlı API bilgileri birlikte kullanıldı; sonuç 401 olur.