KargoJet Dokümantasyon

Gönderi oluşturma API'si

Alıcı, paket ve taşıyıcı bilgileriyle gönderi kaydı oluşturma endpoint'ini kullanın.

Son güncelleme: 2026-05-09

Endpoint

POST/v1/shipments

Yeni gönderi oluşturur. Yanıtta gönderi kimliği, taşıyıcı referansı, takip numarası ve etiket durumu döner.

Örnek istek

{
  "reference": "ORD-10042",
  "recipient": {
    "name": "Ayşe Yılmaz",
    "phone": "5551112233",
    "city": "İstanbul",
    "district": "Kadıköy",
    "address": "Caferağa Mah. Örnek Sok. No: 10"
  },
  "parcel": {
    "widthCm": 20,
    "heightCm": 12,
    "lengthCm": 30,
    "weightKg": 2.4
  },
  "carrierCode": "aras"
}

Yanıt

{
  "id": "shp_01HX...",
  "status": "label_created",
  "trackingNumber": "3489123412",
  "labelUrl": "https://api.kargojet.com/v1/shipments/shp_01HX/label"
}

Doğrulama

  • Alıcı telefon ve adres bilgileri zorunludur.
  • Paket ölçüleri pozitif değer olmalıdır.
  • Taşıyıcı seçilmeden önce fiyat karşılaştırma yapılması önerilir.