Quickstart

🚀 10 Dakikada İlk API Çağrınız

Bu rehber sizi adım adım yönlendirecek. Hiç API deneyiminiz olmasa bile kolayca takip edebilirsiniz.

📋
Başlamadan Önce: Bu rehberi takip etmek için bir UETDS Pro API hesabına ihtiyacınız var. Kayıt ücretsizdir ve 14 gün deneme süresi içerir. Ayrıca UETDS web servis kullanıcı bilgilerinizi e-Devlet üzerinden almanız gerekmektedir. e-Devlet IP Tanımlama Rehberi →
1 Kayıt
2 Token
3 Sefer
4 Gönder
5 Takip
1

Hesap Oluştur ve API Key Al

Firma bilgilerinizle kayıt olun, ilk API key'inizi alın. ?

curl -X POST https://api.depiar.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "organization_name": "Acme Tasimacilik",
    "tax_number": "1234567890",
    "full_name": "Ali Veli",
    "email": "dev@acme.com",
    "password": "StrongPass123"
  }'
⚠️
Önemli: Response'daki api_key değerini güvenli bir yerde saklayın. Bu anahtar tekrar gösterilmez! Kaybederseniz yeni bir anahtar oluşturmanız gerekir.
2

Bearer Token Al

API key'inizi kullanarak Bearer token alın. ?

curl -X POST https://api.depiar.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "demo",
    "client_secret": "sk_live_xxxxxxxxx"
  }'
💡
İpucu: Token'ı direkt API key olarak da kullanabilirsiniz. Authorization: Bearer sk_live_xxx formatında gönderin. Ayrı bir token alma adımı opsiyoneldir.
3

Journey (Sefer) Oluştur

İlk sefer kaydınızı oluşturun. ?

Parametre Tip Açıklama
vehicle_idstringAraç plakası veya sistem ID'si
departure.datestringKalkış tarihi (YYYY-MM-DD)
departure.timestringKalkış saati (HH:MM)
departure.district_idstringKalkış ilçe kodu
tarifeli_contextobjectUETDS tarifeli sefer bilgileri
curl -X POST https://api.depiar.com/api/v1/portal/journeys \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "06ABC123",
    "departure": {
      "date": "2026-02-22",
      "time": "10:00",
      "district_id": "2051"
    },
    "arrival": {
      "date": "2026-02-22",
      "time": "14:00",
      "district_id": "1130"
    },
    "tarifeli_context": {
      "firma_id": 999999,
      "unet_guzergah_kodu": 10001,
      "kalkis_yer_id": 2051,
      "varis_yer_id": 1130,
      "seyahat_suresi_saat": 4
    }
  }'
Başarılı Response: {"id": 1, "status": "draft"} — Journey ID'yi bir sonraki adımda kullanacağız.
4

Journey'yi UETDS'ye Gönder

Oluşturduğunuz journey'yi UETDS sistemine gönderin. ?

curl -X POST https://api.depiar.com/api/v1/portal/journeys/1/submit \
  -H "Authorization: Bearer sk_live_xxx"
ℹ️
Not: Response 202 Accepted döner. Bu, seferin UETDS'ye iletildiği anlamına gelir. Sonucu bir sonraki adımda kontrol edin.
5

Submission Durumunu Kontrol Et

Submit işleminin durumunu ve UETDS referans numarasını görüntüleyin. ?

curl -X GET https://api.depiar.com/api/v1/portal/submissions \
  -H "Authorization: Bearer sk_live_xxx"

🎉 Tebrikler!

İlk API çağrınızı başarıyla tamamladınız!