Geliştiriciler

Sevkiyat360 REST API v1

ERP, WMS, TMS veya araç takip sisteminizi Sevkiyat360'a bağlayın: ilan açın, teklifleri kabul edin, sevkiyat durumunu ve canlı konumu alın, GPS cihazınızdan konum gönderin.

1. Anahtar oluşturun

Panel → Hesap ayarları → API ve entegrasyon bölümünden anahtar oluşturun. Anahtar yalnızca bir kez gösterilir. Hesabınızın onaylı olması gerekir.

2. İsteğe ekleyin

Her isteğe Authorization: Bearer s360_… başlığını ekleyin. Salt okunur anahtarlar yalnızca GET isteği yapabilir. Dakikada 120 istek sınırı vardır.

3. Webhook alın

Olayları anlık almak için webhook adresi tanımlayın. Her istek X-S360-Signature: sha256=… imzasıyla gelir; gövdeyi imza anahtarınızla HMAC-SHA256 ile doğrulayın.

Örnek: açık yükleri listeleme

Örnek: GPS cihazından konum gönderme

Örnek: webhook imzasını doğrulama (Node.js)

Uç noktalar

YöntemAdresAçıklama

Webhook olayları

Hata yanıtları {"error": "açıklama"} biçimindedir: 400 geçersiz veri, 401 anahtar yok/geçersiz, 403 yetki veya onay eksik, 404 kayıt yok, 429 istek sınırı aşıldı. Kayıtlara sayısal kimlik veya kod (YK-26-…, SV-26-…) ile erişebilirsiniz.