HGS Borç Sorgulama Logo HGS Borç Sorgulama
Panele Git →

HGS ihlal sorgulamasını sisteminize entegre edin

Plaka ekleyin, borç durumunu sorgulayın; yeni ihlal tespit edildiğinde webhook bildirimi alın.

curl https://api.hgsborcsorgulama.com/v1/vehicles \
  -H "Authorization: Bearer <api-token>"

        
{

        
  "data": [

        
    {

        
      "id": "01JA6TFKMZVQHPWXN3YBD8C9E2",

        
      "plate_number": "03UN175",

        
      "formatted_plate_number": "03 UN 175",

        
      "total_due_amount": 640,

        
      "query_in_progress": false,

        
      "last_queried_at": "2026-04-16T08:24:13.000000Z",

        
      "created_at": "2025-04-12T11:02:47.000000Z"

        
    }

        
  ]

        
}

      

                  

          

  




  
  

  

          
Hangi sistemlere entegre ediliyor?

    
    

      

    

    

      
        
  
  
  
  
      
      Filo Yönetim Yazılımları
    

    
Yüzlerce aracı manuel kontrol etmek yerine, otomatik sorgulamayla müşterileriniz tüm ihlalleri tek yerden yönetsin.

  



      

    

    

      
        
  
  
  
      
      Araç Takip
    

    
Araç takip ürününüze HGS borç modülü ekleyin. Müşterileriniz ihlalli geçişlerden haberdar olsun.

  



      

    

    

      
        
  
  
  
  
  
  
      
      Lojistik ve Nakliye
    

    
Müşterilerinizin HGS ihlallerini webhook ile anında öğrenin; cezalar büyümeden, icraya düşmeden borçlar kapatılsın.

  



      

    

    

      
        
  
  
  
  
  
  
  
  
  
      
      Muhasebe ve ERP
    

    
Araç masraf modülünüze HGS ihlal kontrolü ekleyin. Otomatik sorgulama tüm ihlalleri masraf raporuna hazır getirsin.

  



      

    

    

      
        
  
  
  
  
  
      
      Kargo ve Teslimat
    

    
Kurye ve kargo filolarınızın HGS ihlallerini otomatik takip edin. Esnaf kurye modelinde araç sahipliği farklı olsa bile.

  



      

    

    

      
        
  
  
  
      
      Oto Kiralama
    

    
Kiralanan araçların HGS ihlallerini teslimatta tespit edin. Müşteriden tahsilat sürecinizi hızlandırın.

  



    

  




  
    

  

          
Üç adımda başlayın

    
    
  




  
  

  

          
Öne çıkan özellikler

    
    

      

    

    

      

        
Kolay Başlangıç

        
Bonus kredi ile ücretsiz başlayın. Başvuru, belge, taahhüt veya satış görüşmesi süreçleri yok.

      

              

          
  
  
  
  
        

          

  



      

    

    

      

        
Sadece Plaka ile Sorgulama

        
Diğer sağlayıcıların aksine HGS etiket sahipliği ya da banka müşterisi olma zorunluluğu yok.

      

              

          
  
  
  
        

          

  



      

    

    

      

        
Otomatik Sorgulama

        
Günlük veya haftalık otomatik sorgulamayı etkinleştirin, ihlal tespitinde webhook ile bildirim alın.

      

              

          
  
  
  
  
  
  
  
        

          

  



    

  




  
  

  

          
Sıkça sorulan sorular

    
    

    

  Bir sorgu ne kadara mal olur?
  

    

      
Başarıyla tamamlanmış her bir yeni ihlal sorgusu 1 (bir) kredidir. Plaka listeleme, araç detayı ve sorgu durumu gibi istekler ücretsizdir. Kredi ücreti satın alınan pakete göre değişkenlik gösterir. Kredi fiyatları için fiyat sayfasına bakabilirsiniz. Yeni hesaplara ücretsiz başlangıç kredisi tanımlanır.


    

  




    

  Başarılı sorgu nedir?
  

    

      
Sorgu isteği HTTP 202 ile kabul edilir, işlem arkaplanda çalışır. Kaynak sistemden hata alınması durumunda sorgular tekrarlanır. Bu tekrarlar bakiyenizi etkilemez. Plakaya ait borç bilgisi alındığında işlem başarılı sayılır ve hesabınızdan 1 sorgu kredisi düşülür.


    

  




    

  Sorgular neden asenkron?
  

    

      
Bir ihlal sorgusu ortalama 10 saniye sürer, kaynak sistemdeki gecikmelere göre bu süre uzayabilir. Senkron bir API yanıtı beklemeyi sizin tarafınıza bırakırdı; webhook modeli sonuç hazır olduğunda size iletir, sizin tarafınızda zaman aşımı veya yarım kalan istek yönetimine gerek kalmaz.


    

  




    

  Webhook kullanamıyoruz, ne yapmalıyız?
  

    

      
Uygulamanız bir güvenlik duvarı arkasında olabilir. Bulut tabanlı altyapımız için sabit IP adresleri sağlayamıyoruz; webhook URL'niz için güvenlik duvarında istisna tanımlanamıyorsa, sorgu sonrasında düzenli aralıklarla araç detayını sorgulayarak durumu takip edebilirsiniz.


Webhook URL'nizi halka açık bırakabiliyorsanız, HMAC-SHA256 ile imzalanan istekleri doğrulayarak kaynağın güvenliğinden emin olabilirsiniz.


Daha detaylı bilgi için API dokümantasyonunu inceleyebilirsiniz.


    

  




    

  Müşterilerim adına sorgulama yapabilir miyim?
  

    

      
Evet. Tek bir API anahtarıyla müşterilerinize ait sınırsız plakayı ekleyip sorgulayabilirsiniz. Araç yönetimi ve kredi bakiyesi entegrasyon tarafında tutulur — son kullanıcılarınızın ayrı hesap oluşturmasına gerek yoktur.


    

  




    

  Kredim biterse servis durur mu?
  

    

      
Hayır. Otomatik kredi yükleme ile bakiyeniz belirlediğiniz seviyenin altına düştüğünde kredi otomatik olarak eklenir. Canlı entegrasyonlarınızda kesintisiz sorgu akışını bu şekilde garantileyin.


    

  




    

  Yabancı plakalar sorgulanabilir mi?
  

    

      
Evet. Türkiye'de HGS ihlali oluşmuş tüm plakalar sorgulanabilir — yabancı plakalar da dahil. Plaka formatı otomatik normalize edilir.


    

  



  

  




  
  

  

    
    

          
Entegrasyona hazır mısınız?

              
API anahtarı oluşturun, dakikalar içinde ilk sorgunuzu çalıştırın.

        

      
      Hemen başlayın
    
    
      API dokümantasyonu