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ı.
sale_amount	Satış tutarına göre birebir sorgulama.
commission_amount	Komisyon tutarına göre birebir sorgulama.
net_amount	Net tutara göre birebir sorgulama. Net tutar, satış tutarından komisyon düşülerek hesaplanır.
issue_start_date	Tanzim tarihi aralığı başlangıcı. Bu tarihte veya sonrasında oluşturulan kayıtlar döner. Format: YYYY-MM-DD.
issue_end_date	Tanzim tarihi aralığı bitişi. Bu tarihte veya öncesinde oluşturulan kayıtlar döner. Format: YYYY-MM-DD.
start_date	Aktiflik aralığı başlangıcı. Bu tarihte veya sonrasında aktif olan kayıtlar döner. Format: YYYY-MM-DD.
end_date	Aktiflik aralığı bitişi. Bu tarihte veya öncesinde aktif olan kayıtlar döner. 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" \
    --data-urlencode "issue_start_date=2026-07-01" \
    --data-urlencode "issue_end_date=2026-07-01"

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ı, satış tutarı, komisyon tutarı, net tutar, para birimi, ödeme durumu ve iptal bilgisi yer alır.

Alan	Açıklama
sale_amount	Siparişin satış tutarı.
commission_amount	Sipariş için hesaplanan bayi komisyon tutarı.
net_amount	Satış tutarından komisyon düşüldükten sonra kalan net tutar.
currency	Tutar para birimi. Varsayılan değer TRY.

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.