API · v1

Entwickler

Integrieren Sie ChinaLogisticHub mit ERP, TMS oder BI-Tools über eine signierte REST-API und HMAC-verifizierte Webhooks.

Swagger UI (nicht produktiv)OpenAPI-JSON-Dokument

basehttps://api.chinalogistichub.com/api/v1/api/v1

REST

OpenAPI-described JSON endpoints.

Webhooks

HMAC-SHA256 signed event delivery.

Rate-aware

60 rpm default, enterprise raises it.

Authentifizierung

Erstellen Sie einen API-Schlüssel im Unternehmens-Dashboard. Senden Sie ihn in einem dieser Header:

Das vollständige Secret wird nur einmal bei der Erstellung angezeigt. Bei Leak sofort widerrufen.

request.http·

Authorization: Bearer clh_live_<prefix>_<secret>
# or
X-API-Key:     clh_live_<prefix>_<secret>

Schnellstart

curl200 OK

curl -H "Authorization: Bearer $CLH_KEY" \
     https://api.chinalogistichub.com/api/v1/api/v1/public/ping

OpenAPI-Spezifikation

Maschinenlesbarer Vertrag für die Code-Generierung (openapi-generator, orval usw.).

Swagger UI (nicht produktiv)

POST/api/v1/requestsCreate a freight request

GET/api/v1/requests/{id}/quotesList quotes for a request

POST/api/v1/quotes/{id}/awardAward a winning carrier quote

GET/api/v1/shipments/{id}Get shipment + tracking events

GET/api/v1/shipments/{id}/documentsList shipment documents

POST/api/v1/developers/webhooksSubscribe to event webhooks

Webhooks

Abonnieren Sie Events über POST /api/v1/developers/webhooks . Jede Zustellung trägt eine HMAC-SHA256-Signatur in X-CLH-Signature.

Wiederholungs-Richtlinie

6 Zustellversuche mit exponentiellem Backoff ab 30 Sekunden. Anfragen, die nie GET /developers/webhooks/:id/deliveries

Signaturheadernode

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| > 300s

Unterstützte Events

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

Ratenlimits

Standard: 60 Requests / Minute / API-Schlüssel. Enterprise-Tarife haben höhere Limits.

ship faster

Bereit zur Integration? Schlüssel im

Entwickler-Dashboard