Online Çekici Logo

Çekici talebini kendi sisteminizden açın.

REST API ile fiyat sorgulayın, talep oluşturun, durumu izleyin. Kullanıcınız uygulamanızdan hiç çıkmaz; çekiciyi arkada biz göndeririz.

Kurumsal Hesap Oluştur Dokümantasyon isteyin

Sistemin uçtan uca nasıl çalıştığını görmek için kurumsal çözümler sayfamıza bakın.

talep oluştur
POST /company/service-requests

{
  "external_code": "SRV-4471",
  "plate": "34ABC001",
  "vehicle_type_id": 1,
  "service_id": 1
}

Akış nasıl işliyor?

Dört adımda kurulur. Sonrasında talebin her durum değişikliği size webhook olarak düşer.

  1. 1

    Token alın

    Kurumsal panelinizden API token’ınızı oluşturun.

  2. 2

    Fiyat sorgulayın

    Koordinat ve araç tipiyle tutarı, mesafeyi ve tahmini süreyi alın.

  3. 3

    Talep oluşturun

    Talebi kendi referans numaranızla açın; en uygun çekici atanır.

  4. 4

    Süreci izleyin

    Webhook ile bildirim alın veya talebi tekil olarak sorgulayın.

Kimlik doğrulama

API, bearer token ile çalışır. Token’ınızı kurumsal panelde Ayarlar bölümünden oluşturursunuz ve her istekte Authorization başlığında gönderirsiniz.

Temel adres

https://api.onlinecekici.com

İstek başlıkları

Authorization: Bearer TOKENINIZ
Accept: application/json
Content-Type: application/json

Uç noktalar

İstek ve yanıt şemalarının tamamı, örnek çağrılarla birlikte ayrıntılı dokümantasyonda yer alıyor. Dokümantasyonu entegrasyon sürecinde ekibinizle paylaşıyoruz.

MetodUç noktaAçıklama
POST/v1/price/calculateAlım ve teslim koordinatları, araç tipi ve hizmete göre fiyat, mesafe ve tahmini süre döner.
POST/company/service-requestsYeni çekici veya yol yardım talebi oluşturur. Kendi referans numaranızı external_code ile iletebilirsiniz.
GET/company/service-requests/{id}Talebin güncel durumunu, atanan sürücüyü ve fiyat bilgisini döner.
PUT/company/service-requests/{id}/assign-towing-companyTalebi kendi anlaşmalı çekici tedarikçinize atar.
DELETE/company/service-requests/{id}/cancelTalebi iptal eder. İptal gerekçesi zorunludur.
POST/company/service-requests/{id}/completeTalebi tamamlanmış olarak işaretler.

Taleplerinizin toplu listesini, filtreleri ve CSV dışa aktarımını kurumsal panelden kullanırsınız; API tekil talep sorgulaması sunar.

Örnek: talep oluşturma

Talebi kendi referans numaranızla (external_code) gönderin. Aynı kodla gelen ve henüz tamamlanmamış bir talep varsa mevcut talep güncellenir, böylece yeniden denemeleriniz mükerrer kayıt oluşturmaz.

Ücretli taleplerde aracın durumunu vehicle_status nesnesindeki altı soruyla iletirsiniz; fiyat buna göre hesaplanır. Sözleşmeli taleplerde (is_contracted: true) bunun yerine is_crashed ve is_locked alanları kullanılır. 

curl -X POST https://api.onlinecekici.com/company/service-requests \
  -H "Authorization: Bearer TOKENINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "external_code": "SRV-4471",
    "name": "Ahmet Yılmaz",
    "phone_code": "90",
    "phone": "5321112233",
    "plate": "34ABC001",
    "brand": "Renault",
    "model": "Clio",
    "vehicle_type_id": 1,
    "service_id": 1,
    "pickup_lat": 38.72056696564257,
    "pickup_lng": 35.482943322753904,
    "dropoff_lat": 38.7249024,
    "dropoff_lng": 35.45720464,
    "vehicle_status": {
      "is_on_four_wheels": true,
      "is_gear_neutral": true,
      "is_steering_moving": true,
      "is_original_height": true,
      "has_load": false,
      "is_handbrake_neutral": false
    },
    "is_contracted": false,
    "note": "Araç kapalı otoparkta, -2. kat"
  }'

Webhook bildirimleri

Panelde bir webhook adresi ve hangi olaylarda bildirim almak istediğinizi tanımlarsınız. Seçtiğiniz her olayda adresinize imzalı bir POST isteği göndeririz.

Bildirim gönderilen olaylar

  • 1

    Onaylandı

    İş onaylandığında gönderilir

  • 2

    İş Alındı

    İş bir çekici tarafından alındığında gönderilir

  • 3

    İşe Başlanıldı

    Çekici yola çıktığında gönderilir

  • 4

    Tamamlandı

    Araç teslim edildiğinde gönderilir

  • 5

    İptal Edildi

    Talep iptal edildiğinde gönderilir

  • 6

    Ödendi

    Müşteri ödemeyi yaptığında gönderilir

  • 9

    Çekici Firması Atandı

    Talebe çekici firması atandığında gönderilir

  • 10

    Sürücü Atandı

    Talebe sürücü atandığında gönderilir

  • 13

    Talep Güncellendi

    Talep bilgileri değiştiğinde gönderilir

  • 15

    Fiyat Güncellendi

    Talebin fiyatı değiştiğinde gönderilir

Gelen istek gövdesi

Kısaltılmış örnek. Gövde ayrıca alım ve teslim konumlarını, araç tipini, çekici firmasını ve zaman damgalarını da taşır. 

{
  "event": {
    "id": 10,
    "label": "Sürücü Atandı"
  },
  "service_request": {
    "id": 48219,
    "code": "ONC-20260813MAOL",
    "status": {
      "id": 2,
      "label": "Çekici talebinizi kabul etti"
    },
    "customer": {
      "name": "Ahmet Yılmaz",
      "phone_code": "90",
      "phone": "5321112233"
    },
    "driver": {
      "name": "Mehmet Kaya",
      "phone": "905331112233"
    },
    "details": {
      "distance": 12.4,
      "duration": "18 dakika",
      "price": 2450
    }
  }
}

İmza doğrulama

Her istek, gövdenin HMAC-SHA256 imzasını taşıyan bir X-Signature başlığı içerir. Kendi tarafınızda doğrulayın: 

$payload = file_get_contents('php://input');
$signature = hash_hmac('sha256', $payload, $webhookSecret);

if (!hash_equals($signature, $request->header('X-Signature'))) {
    abort(401, 'Invalid signature');
}

Sık sorulan sorular

Entegrasyona başlayalım

Kurumsal hesabınızı oluşturun; onaydan sonra token’ınızı üretip ilk talebinizi gönderebilirsiniz. Teknik ekibimiz süreç boyunca yanınızda.

Kurumsal Hesap Oluştur Dokümantasyon isteyin

Teknik sorularınız için:

0850 242 92 46 info@onlinecekici.com
Online Çekici Logo
Online Çekici olarak 7/24 acil yol yardım hizmeti sunuyoruz. Türkiye'nin her yerinde hizmet veren Yol Yardım, araç çekici ve oto kurtarıcı hizmetleri sunuyor.

Başlıca Hizmetlerimiz

  • Çekici Hizmeti

  • Kurtarıcı Hizmeti

İletişim

Güvenli ödeme ve Troy logoları

Copyright © 2026 onlinecekici.com

Checkmate Future Yazılım Teknoloji A.Ş. - We Love Google.

Hemen Ara: 0850 242 92 46