Bayi Entegrasyon API

Bayi Sorgulama API Dokümantasyonu

Bu API, bayilerimizin panele giriş yapmadan kendi kayıtlarını yetkili entegrasyon firmaları üzerinden sorgulaması için hazırlanmıştır.

Bayi Kodu

Bayi panelindeki API Erişimi alanından alınır. Kodlar BY1001 formatında, en eski bayiden yeni bayiye doğru sıralı atanır.

API Key

16 karakterlik benzersiz erişim anahtarıdır.

Secret Key

16 karakterlik gizli anahtardır; isteklerde gönderilmez, HMAC imza üretmek için kullanılır.

Bayi API bilgilerine nasıl ulaşılır?

Bayi paneline giriş yaptıktan sonra Hesabım > API Erişimi sekmesine girerek Bayi Kodu, API Key ve Secret Key bilgilerinizi görüntüleyebilirsiniz.

https://bayi.cepmobil.net/bayi/hesap

Endpoint

GET https://api.cepmobil.net/api/v1/dealer/policies/search

Aynı endpoint POST isteğiyle de kullanılabilir.

Header Bilgileri

X-Dealer-Code: BAYI_KODU
X-Api-Key: API_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256
Accept: application/json

İmza metni: BAYI_KODU|API_KEY|UNIX_TIMESTAMP. HMAC algoritması SHA-256, HMAC anahtarı ise Secret Key olmalıdır. Timestamp en fazla 5 dakika sapma ile kabul edilir.

Sorgu Parametreleri

Parametre	Açıklama
branch_name	Branş/paket/araç tipi adına göre arama.
policy_no	Poliçe/sipariş/doküman numarası.
plate	Araç plakası.
identity_no	TCKN veya vergi kimlik numarası.
customer_name	Hizmet alan müşteri ad soyad veya firma adı.
start_date	Başlangıç tarihi alt sınırı. Format: YYYY-MM-DD.
end_date	Bitiş tarihi üst sınırı. Format: YYYY-MM-DD.
per_page	Sayfa başı kayıt. Varsayılan 25, maksimum 100.

Örnek cURL

timestamp=$(date +%s)
dealer_code="BY1001"
api_key="1234567890ABCDEF"
secret_key="ABCDEF1234567890"
signature=$(printf "%s|%s|%s" "$dealer_code" "$api_key" "$timestamp" | openssl dgst -sha256 -hmac "$secret_key" -hex | awk '{print $2}')

curl -G "https://api.cepmobil.net/api/v1/dealer/policies/search" \
    -H "X-Dealer-Code: $dealer_code" \
    -H "X-Api-Key: $api_key" \
    -H "X-Timestamp: $timestamp" \
    -H "X-Signature: $signature" \
  --data-urlencode "plate=38ABC123"

Dönen Temel Alanlar

Cevapta branş adı, poliçe no, yenileme no, varsa zeyil no, iptal zeyil durumu, tanzim tarihi, başlangıç/bitiş tarihi, bayi adı, bayi kodu, TCKN/VKN, plaka, hizmet alan müşteri adı soyadı, paket adı, ödeme durumu ve iptal bilgisi yer alır.

Güvenlik

API bilgileri yalnızca yetkili entegrasyon firmasıyla paylaşılmalıdır. Anahtarlar bayi panelinden yenilenirse eski bilgilerle erişim durur.

Her bayi yalnızca kendi API bilgileriyle ve yalnızca kendi kayıtlarını sorgulayabilir. dealer_id veya main_dealer_id gibi bayi değiştirmeye yönelik parametreler kabul edilmez.