Geliştiriciler · API & Entegrasyon

Çekiciler.tr geliştirici platformu.

Sigorta şirketleri, kurumsal filo yöneticileri ve teknoloji partnerleri için RESTful API, webhook altyapısı ve OAuth 2.0 ile güvenli entegrasyon.

API Erişimi Talep Et → Dokümantasyon
Özellikler

Modern, güvenli ve şeffaf API

Bir bütün olarak geliştirici deneyimi için tasarlanmış altyapı.

RESTful JSON API

Standart REST API. JSON payload. HTTPS only. Tüm response'lar UTF-8.

Webhook Push

Talep, teklif, kabul ve tamamlama event'leri için anlık webhook bildirimi. HMAC-SHA256 imzalı.

OAuth 2.0

Standart OAuth 2.0 authorization code flow ve client credentials. Token rotation desteği.

Rate Limiting

1000 req/dakika sandbox · 10000 req/dakika production. Yumuşak limit aşımında 429 + Retry-After.

Sandbox Ortamı

Tam fonksiyonel test ortamı. Mock veriler. Üretim verilerinizi etkilemez.

SDK & Dokümantasyon

PHP, Python, Node.js, Go ve .NET için resmi SDK'lar. Postman koleksiyonu + OpenAPI 3.0 spec.

Hızlı Başlangıç

5 dakikada ilk API çağrınızı yapın

Sandbox API key ile localhost'tan ilk talep oluşturma örneği.

1. API key alın

Sandbox API key için bd@cekiciler.tr adresine yazın. Genelde 1 iş günü içinde size sandbox key ve dokümantasyonu göndeririz.

  • Sandbox endpoint: https://sandbox-api.cekiciler.tr
  • Production endpoint: https://api.cekiciler.tr
  • API versiyon: v1
  • Authentication: Bearer {token}

2. İlk çağrı — talep oluştur

Aşağıdaki curl komutunu kendi sandbox key'inizle güncelleyip çalıştırın:

# Yeni talep oluştur curl -X POST "https://sandbox-api.cekiciler.tr/v1/requests" \ -H "Authorization: Bearer sk_test_xxx..." \ -H "Content-Type: application/json" \ -d '{ "vehicle_type": "kurtarici_flatbed", "pickup": { "province_id": 34, "district_id": 422, "address": "Bağdat Cd. No:124" }, "is_urgent": true, "customer_email": "demo@example.com" }'
Endpoint'ler

v1 REST API kaynak özeti

En çok kullanılan endpoint'ler — tam liste için OpenAPI spec'imize bakın.

POST
/v1/requests
Yeni talep oluşturur, paralel teklif akışını başlatır.
Sürücü
GET
/v1/requests/{id}/offers
Talebe gelen teklifleri listeler. Filtreleme: fiyat, puan, varış süresi.
Sürücü
POST
/v1/offers/{id}/accept
Teklifi kabul eder, firmaya iletişim bilgilerini iletir.
Sürücü
GET
/v1/companies/nearby
Belirli koordinata yakın onaylı firmaları listeler.
Kurumsal
POST
/v1/companies/{id}/offers
Firma adına teklif gönderir. Webhook authentication zorunlu.
Firma
GET
/v1/webhooks
Tanımlı webhook listeniz. Her hesap için max 10 endpoint.
Tüm
PUT
/v1/webhooks/{id}
Webhook URL ve subscribed event'leri günceller.
Tüm

Tam REST referansı, OpenAPI spec ve Postman koleksiyonu için bd@cekiciler.tr

Partner Senaryoları

Kimler API kullanır?

Türkiye'nin önde gelen sigorta şirketleri, kurumsal filo yöneticileri ve teknoloji partnerleri için kullanım örnekleri.

15+

Sigorta Şirketleri

Kasko sigortası için otomatik çekici çağırma. Sigortalının deneyimi tek bir başvuruda biter.

8+

Filo Operatörleri

Kurumsal filo araçları için yola kalma durumunda merkez ofisten otomatik talep oluşturma.

25+

OEM & Servis Ağları

Otomotiv markaları ve yetkili servisler için garanti dönemi yol yardımı altyapısı.

İş Geliştirme ile İletişime Geç →