HGS RADAR API | Geliştirici Portalı & Headless Entegrasyon

BAĞIMSIZ API PAKETLERİ

Yazılım & ERP Entegrasyon Tarifeleri

SaaS filo yönetim paneli aboneliğinden bağımsızdır. Doğrudan API anahtarı alın ve uygulamanıza bağlayın.

API Starter

10.000 Sorgu/Ay

Küçük ölçekli kurum içi yazılımlar ve startup'lar için temel API paketi.

₺790 /ay

Yıllık faturalandırılır (₺9.480/yıl)

10.000 Başarılı Sorgu / Ay
10 Otoyol Operatörü Canlı Tarama
Tekil & Toplu Batch Sorgu
15 Günlük Cezasız Süre Hesabı
Webhook Desteği Yok

Starter API Başlat

EN ÇOK TERCİH EDİLEN

API Growth

50.000 Sorgu/Ay

Büyüyen yazılım evleri, ERP entegrasyonları ve lojistik platformları için tam donanım.

₺1.990 /ay

Yıllık faturalandırılır (₺23.880/yıl)

50.000 Başarılı Sorgu / Ay
Gerçek Zamanlı Webhook Olayları
Logo, Mikro, SAP ERP Uyumlu Yanıtlar
5 Eşzamanlı İstek (Concurrency)
Öncelikli Geliştirici Slack/E-posta Desteği

Growth API'yi Başlat

API Scale

200.000+ Sorgu/Ay

Yüksek hacimli filo takip sağlayıcıları, bankalar ve kurumsal holdingler.

Özel /teklif

Hacme göre ölçeklenen kurumsal SLA

200.000+ veya Sınırsız Hacim
Dedike IP ve Proxy Havuzu
Özel Entegrasyon Mühendisi
%99.9 Uptime SLA Hukuki Taahhüdü
Özel Veri Saklama ve On-Premise Gateway

Satış Ekibiyle Görüş

İNTERAKTİF TEST ALANI

Canlı API Test Playground

Kod yazmadan doğrudan API'yi test edin. Bir plaka girin ve canlı JSON yanıtını anında inceleyin.

POST /api/v1/violations/check

Test Araç Plakası

Sorgulanacak Operatörler

KGM (Devlet) KMO (Kuzey Marmara) İCA (3. Köprü) Avrasya Tüneli

Simüle Edilen API Anahtarı

Response Terminal

200 OK • 164ms

{
  "status": "success",
  "plate": "34VR1907",
  "scanned_at": "2026-09-27T16:15:00Z",
  "total_debt": 385.50,
  "potential_penalty_debt": 1927.50,
  "risk_level": "CRITICAL",
  "violations_count": 2,
  "violations": [
    {
      "violation_id": "KMO-20260920-8472",
      "operator": "KMO",
      "operator_title": "Kuzey Marmara Otoyolu",
      "toll_amount": 210.00,
      "penalty_amount": 840.00,
      "days_left_grace_period": 2,
      "status": "CRITICAL_RISK"
    },
    {
      "violation_id": "ICA-20260925-1102",
      "operator": "ICA",
      "operator_title": "Yavuz Sultan Selim Köprüsü",
      "toll_amount": 175.50,
      "days_left_grace_period": 13,
      "status": "GRACE_PERIOD"
    }
  ]
}

KOD ÖRNEKLERİ

5 Dakikada Sisteminize Entegre Edin

cURL, Python veya Node.js ile tek satırda canlı plaka sorgulaması yapın.

X-API-Key Yetkilendirme

# Canlı Tekil Plaka İhlal ve Risk Sorgusu
curl -X POST https://api.hgsradar.com/v1/violations/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hgs_sec_live_9f82d1c07a4b..." \
  -d '{
    "plate": "34VR1907",
    "force_fresh_scrape": true
  }'

API REFERANSI

Temel Endpoint Mimarisi

Tüm yanıtlar standart JSON ve HTTP durum kodlarıyla döndürülür.

POST /api/v1/violations/check

Tekil plaka için 10 otoyol operatöründe (KGM, İCA, KMO, Avrasya vb.) canlı ihlal taraması yapar. 15 günlük cezasız indirim süresini dakika dakika hesaplar.

Parametreler: { "plate": "34VR1907", "operators": ["KGM", "ICA", "KMO"], "force_fresh_scrape": true }

POST /api/v1/violations/batch

Tek istekte 500 plakaya kadar toplu filo plaka sorgulaması yapar. Asenkron veya senkron konsolide borç tablosu oluşturur.

Parametreler: { "plates": ["34VR1907", "06AAA01", "35XYZ99"] }

GET /api/v1/tenants/{id}/vehicles/{v_id}/history

Aracın geçmişteki tüm tarama kayıtlarını (`scan_logs`) ve ödenen ihlallerinin zaman çizelgesini (`paid_at`) döner.

GERÇEK ZAMANLI OLAYLAR

Olay Tabanlı Webhook Bildirimleri

Sürekli sorgu atmanıza gerek kalmaz. Bir ihlal oluştuğunda veya ödendiğinde sisteminize HTTP POST sinyali iletilir.

violation.detected

Filodaki herhangi bir araç için yeni bir otoyol geçiş ihlali tespit edildiğinde tetiklenir. Asıl tutar ve gişe bilgilerini içerir.

violation.paid

Daha önce açık olan ihlalin ödendiği tespit edildiğinde tetiklenir. Borç sistemde kapatılır ve `paid_at` bilgisi iletilir.

violation.risk_critical

15 günlük cezasız yasal sürenin bitimine 48 saatten az kaldığında ve 4 kat ceza riski doğduğunda acil uyarı sinyali gönderilir.

ERP ve Filo Yazılımınızı Bugün Bağlayın

Dakikalar içinde API anahtarınızı oluşturun, sandbox ortamında test edin ve canlıya geçin.

API Anahtarını Hemen Oluştur Filo Yönetim Paneline Git

Tüm Otoyollar Tek Bir Headless REST API'de