API · v1
Geliştiriciler
ChinaLogisticHub'ı imzalı REST API ve HMAC doğrulamalı webhook'larla ERP, TMS veya BI araçlarınıza entegre edin.
https://api.chinalogistichub.com/api/v1/api/v1REST
OpenAPI-described JSON endpoints.
Webhooks
HMAC-SHA256 signed event delivery.
Rate-aware
60 rpm default, enterprise raises it.
01
Kimlik Doğrulama
Şirket kontrol panelinizden bir API anahtarı oluşturun. Aşağıdaki başlıklardan birinde gönderin:
Tam gizli anahtar yalnızca oluşturulma anında gösterilir. Sızdırılırsa derhal iptal edin.
Authorization: Bearer clh_live_<prefix>_<secret> # or X-API-Key: clh_live_<prefix>_<secret>
02
Hızlı Başlangıç
curl -H "Authorization: Bearer $CLH_KEY" \
https://api.chinalogistichub.com/api/v1/api/v1/public/ping03
OpenAPI Spesifikasyonu
Kod üretimi için uygun makine okunabilir sözleşme (openapi-generator, orval vb.).
/api/v1/requestsCreate a freight request/api/v1/requests/{id}/quotesList quotes for a request/api/v1/quotes/{id}/awardAward a winning carrier quote/api/v1/shipments/{id}Get shipment + tracking events/api/v1/shipments/{id}/documentsList shipment documents/api/v1/developers/webhooksSubscribe to event webhooks04
Webhook'lar
Olaylara abone olun: POST /api/v1/developers/webhooks . Her teslimat şu başlıkta HMAC-SHA256 imzası taşır: X-CLH-Signature.
Yeniden deneme politikası
30 saniyeden başlayan üstel geri çekilmeyle 6 teslim denemesi. 2xx dönmeyen istekler dead-letter loguna düşer: GET /developers/webhooks/:id/deliveries
X-CLH-Signature: t=1713398400,v1=<hex>
const base = `${t}.${rawBody}`;
const expected = crypto.createHmac('sha256', secret)
.update(base).digest('hex');
// Compare with timingSafeEqual, reject if |now - t| > 300sDesteklenen olaylar
- request.created
- request.status_changed
- shipment.created
- shipment.status_changed
- shipment.delivered
- quote.received
- quote.awarded
- quote.selected_confirmed
- invoice.paid
- document.uploaded
- document.expiring
05
İstek Limitleri
Varsayılan: API anahtarı başına 60 istek / dakika. Enterprise planlar limitleri yükseltir.