Public API v1 sözleşmesi Gönderiler PA-02

Gönderi detayı

GET/api/v1/shipments/{id}

Amaç

Tek gönderiyi koliler, olay akışı ve taşıyıcı özetiyle okumak.

Yetki

Bearer anahtar; başka tenant'ın kaydı ve biçimsiz ULID 404 (varlık sızdırılmaz).

Parametre

id (path, ULID).

Başarı 200

{data, meta.carrier_capabilities} (ortak nesne, detay projeksiyonu).

Hatalar

401, 404, 429.

kabuk

curl "{{base_url}}/shipments/01K1GNDR000000000000000001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"

Örnek yanıt (kısaltılmış):

json

{
  "data": {
    "id": "01K1GNDR000000000000000001",
    "delivery_no": "SVKAB12CD34EF",
    "barcode": "SVKAB12CD34EF",
    "tracking_url": null,
    "status": "CREATED",
    "origin": "created",
    "buyer_name": "Ornek Alici",
    "buyer_phone": "5550000000",
    "buyer_email": null,
    "buyer_address": "Ornek Mah. Deneme Cad. No:1",
    "buyer_city": "Istanbul",
    "buyer_district": "Kadikoy",
    "buyer_tax_number": null,
    "order_reference": null,
    "order_price": null,
    "desi": "2.50",
    "carrier_account": {"id": "01K1TSYC000000000000000001", "name": "Hepsijet", "carrier_code": "hepsijet"},
    "parcels": [{"no": 1, "reference": null, "desi": "2.50", "content": null}],
    "events": [{"occurred_at": "2026-07-23T10:15:00Z", "status": "CREATED", "raw_status": "CREATED", "location": null, "description": "Gönderi Sevkora üzerinden oluşturuldu.", "source": "system"}],
    "created_at": "2026-07-23T10:15:00Z",
    "updated_at": "2026-07-23T10:15:00Z"
  },
  "meta": {"carrier_capabilities": ["createShipment", "cancelShipment", "recallShipment", "getLabel", "trackShipment", "getReturnSlots", "registerSender", "geoLookup"]}
}