API Referansı

Hanc.AI'yi uygulamalarınıza entegre etmek için eksiksiz API dokümantasyonu. Ajanları yönetin, çağrı verilerini alın, çağrı yapın ve platformun her bölümünü programatik olarak çalıştırın.

---

Hızlı genel bakış

Temel URL	https://api.hanc.ai
Kimlik Doğrulama	x-api-key başlığı ile API Anahtarı
Format	JSON

Kontrol panelindeki Entegrasyon → API Anahtarları bölümünden bir API anahtarı oluşturun. Kullanıcı başına en fazla 3 anahtara sahip olabilirsiniz — kurulum, izinler ve güvenlik rehberi için Entegrasyonlardaki API Anahtarları bölümüne bakın.

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

---

Kullanılabilir uç noktalar

Çağrılar

Eylem	Yöntem	Uç Nokta
Çağrıları listele	GET	/v1/call/list
Çağrı detayları (transkript, duygu, özet)	GET	/v1/call/:id
Genel analitik (tarih/ajana göre metrikler)	GET	/v1/call/general-metrics
Günlük analitik	GET	/v1/call/daily-metrics
Duygu istatistikleri	GET	/v1/call/sentiment-stats
Maliyet dağılımı	GET	/v1/call/costs-breakdown
Çağrıları dışa aktar (CSV)	GET	/v1/call/list/export
Maliyetleri dışa aktar (CSV)	GET	/v1/call/costs-breakdown/export
Telefon çağrısı yap	POST	/v1/call/make-phone-call
Web çağrısı yap	POST	/v1/call/make-web-call

Ajanlar

Eylem	Yöntem	Uç Nokta
Ajanları listele	GET	/v1/agent/list
Ajan detayları	GET	/v1/agent/:id
Ajan oluştur	POST	/v1/agent
Ajan güncelle	PATCH	/v1/agent/:id
Ajan sil	DELETE	/v1/agent/:id
Ajan çağrı istatistikleri	GET	/v1/agent/:id/call-stats
Ajan şablonlarını listele	GET	/v1/agent/agent_template/list

Ajan Eylemleri:

Eylem	Yöntem	Uç Nokta
Eylemleri listele	GET	/v1/agent/:id/actions
Eylem ekle	POST	/v1/agent/:id/actions
Eylem güncelle	PATCH	/v1/agent/:id/actions/:actionId
Eylem sil	DELETE	/v1/agent/:id/actions/:actionId

Ajan Araçları:

Eylem	Yöntem	Uç Nokta
Araçları listele	GET	/v1/agent/:id/tools
Araç ekle	POST	/v1/agent/:id/tools
Araç güncelle	PATCH	/v1/agent/:id/tools/:toolId
Araç sil	DELETE	/v1/agent/:id/tools/:toolId

Bilgi Tabanı

Eylem	Yöntem	Uç Nokta
Bilgi tabanlarını listele	GET	/v1/knowledge-base/list
Bilgi tabanı oluştur	POST	/v1/knowledge-base
Dosya(ları) yükle	POST	/v1/knowledge-base/:id/file(s)
Dosya sil	DELETE	/v1/knowledge-base/:id/file
Ajan ata	PUT	/v1/knowledge-base/:id/agents

Telefon Numaraları

Eylem	Yöntem	Uç Nokta
Numaraları listele	GET	/v1/phone-number/list
Müsait numaralar (ülkeye göre)	GET	/v1/phone-number/available
Numara satın al	POST	/v1/phone-number/buy
Numara içe aktar	POST	/v1/phone-number/import
SIP'ye bağlan	PATCH	/v1/phone-number/connect-to-sip

Sesler

Eylem	Yöntem	Uç Nokta
Sesleri listele	GET	/v1/voice/list

Dile göre filtrele: GET /v1/voice/list?language=de

Abonelik

Eylem	Yöntem	Uç Nokta
Abonelik detayları	GET	/v1/subscription
Otomatik kredi yüklemesi yapılandır	PATCH	/v1/subscription/auto-top-up
Kredi yükleme miktarını ayarla	PATCH	/v1/subscription/top-up-amount

Müşteriler

Eylem	Yöntem	Uç Nokta
Müşterileri listele	GET	/v1/customer/list
Müşteri detayları	GET	/v1/customer/:id
Müşteri oluştur	POST	/v1/customer
Müşteri güncelle	PATCH	/v1/customer/:id
Müşteri sil	DELETE	/v1/customer/:id

Çalışma Alanları

Eylem	Yöntem	Uç Nokta
Çalışma alanı işlemleri	GET/POST/PATCH/DELETE	/v1/workspaces/*
Üye davet et	POST	/v1/workspaces/:id/invite-member
Üye kaldır	DELETE	/v1/workspaces/:id/invite-member

---

API üzerinden kullanılamayan özellikler

Bazı işlemler yalnızca kontrol paneli üzerinden kullanılabilir:

Özellik	Neden
API anahtarı yönetimi	Güvenlik — anahtarlar başka anahtarlar oluşturamaz
Telefon numarası kurulumu	Etkileşimli kurulum gerektirir
Google Calendar entegrasyonu	Etkileşimli yetkilendirme gerektirir
Faturalama ve ödemeler	Kontrol paneli üzerinden yönetilir

---

Yardıma mı ihtiyacınız var?

API ile ilgili sorular için destek ekibimizle support@hanc.ai adresinden iletişime geçin.