Başlangıç: ilk gönderiye dört adım

SiparişTakip API'si mağazanızdan kendi kargo hesaplarınızla gönderi oluşturmanızı ve gönderilerin durumunu tek biçimde okumanızı sağlar. Bu sayfa ilk gönderiye kadar olan yolu özetler; ayrıntılar ilgili rehberlerdedir.

• Taban adres: https://api.siparistakip.com/api/v3
• Biçim: JSON. Zamanlar ISO 8601, UTC (2026-11-03T09:15:00Z).
• Kimlik doğrulama: OAuth 2.0 client credentials (Kimlik doğrulama).
• Hatalar: RFC 9457 problem gövdesi, makine kodu code alanında (Hatalar ve sınırlar).

1. Hesap ve kargo hesabı

Panelde hesabınızı açın, ardından çalışacağınız kargo firmasının hesap bilgilerini girin. Denemeye gerçek kargo hesabı olmadan başlamak için panelde Test hesabı aç ile bir test (simulated) kargo hesabı açabilirsiniz; bu hesaba gönderilen istekler kargo firmasına gitmez (Test ortamı).

Kullanabileceğiniz kargo hesaplarını ve kimliklerini (carrier_account_id) API'den okursunuz: GET /api/v3/carrier-accounts (scope shipments:read).

2. API istemcisi

Panelde Entegrasyon → API istemcileri ekranından bir istemci oluşturun ve kullanabileceği scope'ları seçin (varsayılan shipments:read ve shipments:write). İstemcinin client_id ve client_secret değerleri mağaza yazılımınıza girilir. Gizli anahtar yalnız oluşturulduğu anda bir kez gösterilir; kaybederseniz aynı ekrandan yenisini üretirsiniz. Yenileme ve iptal de oradan yapılır (Kimlik doğrulama).

API istemcileriniz API kanalınızdaki gönderileri görür; panelden ya da eklentiden açılan gönderiler API'den okunmaz. Panel ise bütün gönderilerinizi gösterir.

3. Erişim token'ı

İstemci bilgileriyle token alın. Token'ı her istekte Authorization: Bearer … başlığında gönderin.

curl -X POST https://api.siparistakip.com/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=CLIENT_ID \
  -d client_secret=CLIENT_SECRET \
  -d "scope=shipments:read shipments:write"

4. İlk gönderi

curl -X POST https://api.siparistakip.com/api/v3/shipments \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2b7e-siparis-1001" \
  -d '{
    "reference": "SIP-1001",
    "carrier": "ptt",
    "carrier_account_id": 7,
    "recipient": {
      "name": "Ayşe Yılmaz",
      "phone": "5321234567",
      "address_line": "Atatürk Cad. No: 10 D: 3",
      "district": "Altındağ",
      "city": "Ankara"
    },
    "parcels": [{ "weight_grams": 1500, "quantity": 1 }]
  }'

Yanıt 202 Accepted ve gönderinin kendisidir (state: "pending"). Gönderi kargo firmasına arka planda iletilir; sonucu state alanından okursunuz: created olunca kargo firmasında oluşmuştur, failed olursa nedeni last_error alanındadır. Durumu nasıl izleyeceğiniz Gönderileri izleme rehberinde.

Sonraki adımlar

• Gönderi oluşturma: bütün alanlar, toplu gönderi, Idempotency-Key.
• İptal, yeniden deneme, düzeltme: başarısız gönderiyi nasıl kurtarırsınız.
• Örnekler: curl, PHP ve Node.js ile uçtan uca akış.
• API referansı: bütün uçlar ve şemalar.