İçeriğe geç
EN TR
Giriş Yap
GELİŞTİRİCİLER

Kargoyu ürününüze entegre edin

Hesaplar, adresler, fiyatlar, gönderiler ve takip için sade, sürümlenmiş bir REST API — kendi panelimizin kullandığı API’nin aynısı.

API erişimi talep edin Güvenlik
TASARIM İLKELERİ

Kullanmaktan keyif alacağınız bir API

REST + JSON

/api/v1 altında öngörülebilir kaynaklar, net hata kodları ve sürprizsiz davranış.

Varsayılan olarak güvenli

Kısa ömürlü JWT erişim token’ları, yenilenen refresh token’lar ve yeniden kullanım tespiti.

Idempotent yazma işlemleri

Güvenle tekrar deneyin: idempotency anahtarı mükerrer gönderi ve ücretlendirmeyi önler.

Webhook’lar

Sürekli sorgulamak yerine her gönderi durum değişikliğinde bildirim alın.

API REFERANSI

Uç noktalar

Yayındaki uç noktalar erken erişim iş ortaklarına açıktır. Geliştirilmekte olan uç noktalar, entegrasyonunuzu planlayabilmeniz için gösterilmektedir.

Metot Uç nokta Açıklama Durum
POST /api/v1/auth/register Satıcı hesabı oluşturur Yayında
POST /api/v1/auth/login Erişim ve refresh token’larını alır Yayında
POST /api/v1/auth/refresh Token’ları yeniler Yayında
GET /api/v1/auth/me Mevcut satıcı profili Yayında
GET /api/v1/merchant-addresses/type/{type} Gönderici veya alıcı adreslerini listeler Yayında
POST /api/v1/merchant-addresses/type/{type} Adres oluşturur Yayında
POST /api/v1/rates Bir paket için kargo fiyatlarını karşılaştırır Geliştiriliyor
POST /api/v1/shipments Gönderi oluşturur ve etiket satın alır Geliştiriliyor
GET /api/v1/shipments/{id}/tracking Standartlaştırılmış takip zaman çizelgesi Geliştiriliyor
POST /api/v1/ai/shipment-drafts Serbest metni gönderi taslağına dönüştürür Planlandı
EVENT shipment.status_changed Her durum değişikliğinde webhook Planlandı
HIZLI BAŞLANGIÇ

İlk gönderiniz

Önce kimlik doğrulayın, ardından bir gönderi oluşturun. Gönderi uç noktası geliştirilme aşamasındadır; aşağıdaki istek yapısı planlanan sözleşmedir.

1. Giriş yapın
curl -X POST https://api.kodlagonder.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ops@yourstore.com",
    "password": "••••••••"
  }'

# 200 OK
{
  "user":   { "id": 42, "companyName": "Your Store" },
  "tokens": { "accessToken": "eyJhbGciOi…", "tokenType": "Bearer" }
}
2. Gönderi oluşturun (ön izleme)
curl -X POST https://api.kodlagonder.com/api/v1/shipments \
  -H "Authorization: Bearer $KODLAGONDER_TOKEN" \
  -H "Idempotency-Key: order-10482" \
  -H "Content-Type: application/json" \
  -d '{
    "from":   { "addressId": 12 },
    "to":     { "name": "Emma Schneider", "city": "Berlin", "country": "DE" },
    "parcel": { "weightKg": 2.5, "lengthCm": 30, "widthCm": 20, "heightCm": 15 },
    "items":  [{ "description": "Ceramic mugs", "quantity": 4, "valueEur": 48 }],
    "carrier": "auto"
  }'

# 201 Created
{
  "id": "shp_8KQ2…",
  "carrier": "selected-by-ai",
  "label":  { "format": "PDF", "url": "https://…" },
  "customs": { "hsCode": "6912.00", "incoterm": "DAP" },
  "status": "LABEL_CREATED"
}

Daha akıllı göndermeye hazır mısınız?

Erken erişim programına katılın, yapay zekâ odaklı kargo platformunu birlikte şekillendirelim.