Public API nedir?
TicaretDefteri Public API v1, yayınlanan işletme kayıtlarını API key ile dış sistemlere sunar.
Son güncelleme: 18 Haziran 2026
Public API v1, TicaretDefteri üzerinde yayınlanan kayıtları HTTP ile okumak için kullanılan, API key ve scope ile korunan bir arayüzdür. Web siteleri ve entegratörler ham tenant verisi yerine yalnızca Public DTO alır.
Public API v1 nedir?
Public API v1, bir workspace'in yayınladığı kayıtları listeleyen ve tekil kayıt döndüren read-only HTTP arayüzüdür. Her istek API key ile doğrulanır; key scope'u hangi kaynaklara erişilebileceğini sınırlar.
Kimler kullanır?
Ajanslar, freelance geliştiriciler ve işletmenin kendi web sitesi Public API ile menü, ürün veya hizmet listesini çekebilir. Panelden girilen veri ile sitede görünen içerik aynı kaynaktan beslenir.
Güvenlik nasıl sağlanır?
API key'ler hash'lenerek saklanır; scope daraltılabilir ve iptal edilebilir. Yanıtlar Public DTO formatındadır — is_sensitive işaretli alanlar veya ham tenant verisi dışarı çıkmaz.
Örnek kullanım senaryosu
Restoran menüsü panelde güncellenir; web sitesi GET /records endpoint'i ile yalnızca yayınlanmış menü kayıtlarını çeker. QR menü veya vitrin sayfası ayrı CMS gerektirmez.
Sık sorulan sorular
Hosted site ile Public API farkı nedir?
Hosted site platformda sunulan hazır vitrin sayfasıdır. Public API kendi domain ve tasarımınızla headless entegrasyon sağlar.
API key nasıl alınır?
Workspace yöneticisi panelden API key oluşturur, scope atar ve güvenli şekilde entegrasyona verir. Anahtar tarayıcıda saklanmamalıdır.