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.

Rehberi indir (.md)

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.

Temel adres (Base URL)

Sitenin adresinden türetilir; sabit yazılmamıştır.

…

OpenAPI: openapi.json

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

YetkiAnlamı
HTTPKodAçı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.