Geliştiriciler

Kendi sistemine bağla.

REST API, Bearer token ve her modül için OpenAPI sözleşmesi. Olayları imzalı webhook'larla anında al. Test anahtarıyla dene, hazır olunca canlıya geç.

API dokümanı Webhook'lar

Hızlı başlangıç

Üç adımda ilk çağrı

01
Anahtarını al Konsolda Hesabım → API anahtarları'ndan bir token oluştur. Önce test anahtarıyla başla.
02
Base URL'i seç Her modül /v1/<modül> altında: tesvik, e-vizite, common. Adres aynı, davranışı anahtar (test/canlı) belirler.
03
İlk isteğini at Bearer token'ı başlığa koy, çağır. Yanıt JSON; hatalar tutarlı bir gövdeyle döner.

terminal

# Teşvik hesaplamalarını listele
curl https://api.kerte.io/v1/tesvik/calculations \
  -H "Authorization: Bearer YOUR_TOKEN"

Test

Test anahtarı SGK'ya çıkmaz, örnek veri döner. Entegrasyonunu gerçek trafiğe dokunmadan kur.

Canlı

Canlı anahtar gerçek verinle çalışır. Adres aynı; yalnız anahtarı değiştirirsin, kod aynı kalır.

Kaynaklar

Nereden devam edersin

API genel bakış Base URL, ortamlar, OpenAPI sözleşme. Kimlik Token tipleri, scope, başlık. Hatalar Hata gövdesi ve kodları. Webhook İmzalı olay bildirimleri, doğrulama.