API genel bakış
Kerte ürünlerine programatik erişim: REST, Bearer token, OpenAPI sözleşme.
Tüm Kerte ürünleri aynı desende bir REST API üzerinden erişilebilir: JSON gövde, Bearer token kimliği, her modül için OpenAPI 3.1 sözleşmesi.
curl https://api.kerte.io/v1/tesvik/calculations \
-H "Authorization: Bearer YOUR_TOKEN"Base URL
Her modül /v1/<modül> altında:
| Modül | Base URL |
|---|---|
| Teşvik | https://api.kerte.io/v1/tesvik |
| E-Vizite | https://api.kerte.io/v1/e-vizite |
| Ortak | https://api.kerte.io/v1/common |
Ortamlar
Kimlik anahtarları canlı ve test olmak üzere iki modda üretilir; adres aynıdır, davranışı anahtar belirler.
- Canlı anahtar: gerçek verinle çalışır, SGK’ya çıkar.
- Test anahtarı: entegrasyonu denemek için; SGK’ya çıkmaz, örnek veri döner.
OpenAPI sözleşme
Her modülün OpenAPI 3.1 dokümanı https://api.kerte.io/v1/<modül>/openapi.json adresinde. Bu sözleşmeden TypeScript / Python client ya da Postman koleksiyonu üretebilirsin. Resmi @kerte/api-client (TS) yakında.