API TrackingAWB

Autentificare

Pentru endpoint-urile de scriere trimite cheia ca Bearer token:

Authorization: Bearer YOUR_API_KEY

GET /api/v1/tracking/{uuid}, rankings și performance rămân publice (rate limit pe IP).

Tracking — creează / sincronizează

curl -X POST https://www.trackingawb.ro/api/v1/tracking \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "awb": "CV09917839610",
    "carrier": "posta",
    "merchant_reference": "WC-1042",
    "customer_email": "client@example.com"
  }'

Răspunsul include uuid, short_code, short_url, merchant_reference, status normalizat și, când sunt rezolvate, obiectele origin / destination.

merchant_reference = ID comandă din magazin (ex. WooCommerce). Folosește short_url în emailul către client.

WooCommerce

Instalează pluginul din folderul integrations/woocommerce-trackingawb (ZIP), pune cheia API din Admin → Chei API, și lasă pluginul de curier (DPD, Cargus etc.) să creeze AWB-ul. TrackingAWB preia AWB-ul și pune linkul scurt în emailuri.

Documentație API: /api-documentatie

Citește o expediere

GET /api/v1/tracking/{uuid}

Refresh

POST /api/v1/tracking/{uuid}/refresh
Authorization: Bearer YOUR_API_KEY

Short URL

Fiecare expediere primește un cod scurt. Link public: https://www.trackingawb.ro/t/{short_code} (redirect către pagina de tracking).

Alte endpoint-uri publice

• GET /api/v1/rankings/couriers
• GET /api/v1/performance/cities/{slug}
• GET /api/v1/performance/carriers/{slug}
• GET /api/v1/performance/routes