Voyce API dokümantasyonu
Çağrı defterindeki tüm veriye (çağrılar, müşteriler, kaçan çağrılar, sonuç kodları, ham tablolar) dışarıdan salt-okunur erişim ve toplu çıktı. Her yanıt aynı JSON zarfındadır.
Başka bir yapay zekaya bağla
Bu API'yi bir yapay zekaya (ChatGPT, Claude, Hermes, Gemini…) bağlamak için aşağıdaki hazır metni ona ver. Rehber, sistemin ne olduğunu, hangi verinin ne anlama geldiğini (ne olduğunu ve ne olmadığını), sitede gördüğün her şeyin hangi veriden geldiğini ve hangi soruya hangi isteğin atılacağını sade dille anlatır. Anahtarı sen eklersin; rehberin içinde anahtar veya müşteri verisi yoktur.
Bağlantı açamayan bir yapay zekaya “Rehberi kopyala”yı yapıştır. Makine okunur sürüm: ai-guide?format=json · kısa yönlendirme: llms.txt
Rehberi önizle
Yükleniyor…
Veri güncelleme (Voyce → arşiv)
Çağrılar her 10 dakikada (dün + bugün), kaçan çağrı havuzu her 2 dakikada güncellenir; gece 03:30–05:00 arası kesin yenileme ve uzlaştırma çalışır. Sıklıkları değiştirmek, elle güncellemek ve Voyce ile karşılaştırmak için Veri Güncelleme sayfasını veya aşağıdaki “Güncelleme Yönetimi” uçlarını (yönetici belirteci ile) kullanın.
Kimlik doğrulama
Her istekte API anahtarı gönderin (IP kısıtlaması yoktur):
X-API-Key: tvk_… # veya Authorization: Bearer tvk_…
Anahtar üretmek için API Anahtarları sayfasını kullanın.
Yanıt zarfı
{
"success": true,
"data": …,
"message": null,
"error": null,
"pagination": {
"page": 1, "limit": 50, "total": 4535,
"totalPages": 91, "hasMore": true
},
"timestamp": "2026-10-03T09:15:00.000Z"
}
Hatada success:false, data:null ve error:{code,message} döner. Sayfalı olmayan yanıtlarda pagination:null.
Yetkiler (scope) ve hatalar
| Yetki | Anlamı |
|---|
| HTTP | Kod | Açıklama |
|---|
Deneme anahtarı (isteğe bağlı)
Aşağıdaki “Dene” düğmelerinde kullanılır. Yalnız bu sekmenin belleğinde tutulur, hiçbir yere kaydedilmez.