API referansı: REST uçları, kimlik, OpenAPI

Panelde yapabildiğiniz her şeyi API üzerinden de yapabilirsiniz — panel de aynı API’yi kullanıyor. Tüm uçlar /v1/ altında toplanır ve JSON konuşur.

Temel adres

Temel adres : https://api.call2me.app
OpenAPI     : https://api.call2me.app/openapi.json
Swagger UI  : https://api.call2me.app/docs
ReDoc       : https://api.call2me.app/redoc

Swagger UI üzerinden her ucu canlı deneyebilirsiniz: Authorize düğmesine basıp API anahtarınızı yapıştırın, ardından Try it out ile isteği gönderin. Sadece okumak istiyorsanız ReDoc daha sakin bir görünüm sunar.

Kimlik doğrulama

• JWT — panel ve tarayıcı oturumları için. POST /v1/auth/login yanıtında döner, süresi kısadır.
• API anahtarı (sk_) — sunucudan sunucuya entegrasyonlar için uzun ömürlü anahtar. Panelde Ayarlar → API Anahtarları bölümünden üretilir.
• Geçici kullanıcı token’ı (eut_) — mobil ve sunucusuz istemciler için kısa ömürlü, kapsamı sınırlı token.

# Her üç yöntem de aynı başlığı kullanır
curl https://api.call2me.app/v1/agents \
  -H "Authorization: Bearer sk_live_..."

Kimlik ve hesap uçları

POST /v1/auth/register     Yeni kullanıcı kaydı
POST /v1/auth/login        Giriş, JWT döner
POST /v1/auth/refresh      JWT yenileme
GET  /v1/auth/me           Oturumdaki kullanıcı
POST /v1/auth/logout       Çıkış

POST   /v1/api-keys              Yeni API anahtarı
GET    /v1/api-keys              Anahtarları listele
GET    /v1/api-keys/{id}/usage   Anahtar kullanım istatistiği
DELETE /v1/api-keys/{id}         Anahtarı iptal et

Asistan uçları

POST   /v1/agents                      Asistan oluştur
GET    /v1/agents                      Asistanları listele
GET    /v1/agents/{id}                 Asistan detayı
PATCH  /v1/agents/{id}                 Asistanı güncelle
DELETE /v1/agents/{id}                 Asistanı sil
GET    /v1/agents/{id}/stats           Asistan istatistikleri
GET    /v1/agents/stats/global         Tüm asistanların özeti
POST   /v1/agents/{id}/test-function   Fonksiyon/webhook testi

Arama uçları

POST   /v1/calls                      Giden arama başlat (201, status=queued)
GET    /v1/calls                      Aramaları listele
GET    /v1/calls/{id}                 Arama detayı (döküm dahil)
POST   /v1/calls/{id}/end             Devam eden aramayı bitir
GET    /v1/calls/{id}/recording       Kayıt için imzalı bağlantı
GET    /v1/calls/{id}/vcon            vCon olarak dışa aktar
GET    /v1/calls/quality/report       Kalite raporu
DELETE /v1/calls/{id}                 Arama kaydını sil

curl -X POST https://api.call2me.app/v1/calls \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "to_number": "+905321234567",
    "from_number": "+908502345678"
  }'

Bilgi tabanı, numara ve widget

POST   /v1/knowledge-base                     Bilgi tabanı oluştur
GET    /v1/knowledge-base                     Listele
POST   /v1/knowledge-base/{id}/sources        Kaynak ekle
POST   /v1/knowledge-base/{id}/query          Anlamsal arama

GET    /v1/phone-numbers                      Numaraları listele
POST   /v1/phone-numbers/buy                  Numara satın al
POST   /v1/phone-numbers/{id}/assign          Asistana ata
DELETE /v1/phone-numbers/{id}                 Numarayı bırak

POST   /v1/widgets                            Widget oluştur
GET    /v1/widgets/{id}/config                Açık — gömme yapılandırması
GET    /v1/widgets/{id}/embed.js              Açık — çalışma zamanı JS
POST   /v1/widgets/{id}/chat                  Açık — mesaj gönder
GET    /v1/widgets/{id}/preview               Açık — bağımsız önizleme

Kampanya, planlama ve ses oturumu

POST /v1/campaigns                Kampanya oluştur
POST /v1/campaigns/{id}/upload    CSV kişi listesi yükle
POST /v1/campaigns/{id}/start     Aramayı başlat
POST /v1/campaigns/{id}/pause     Duraklat
GET  /v1/campaigns/{id}/results   Sonuçları CSV olarak indir

POST /v1/schedules                Planlı arama oluştur
DELETE /v1/schedules/{id}         İptal et

POST /v1/voice/sessions           Headless sesli oturum (LiveKit token döner)
GET  /v1/voice/sessions/{room}    Oturum detayı + döküm
POST /v1/livekit/token            Tarayıcı sesli görüşme token’ı

Cüzdan ve ödeme

GET  /v1/wallet/balance           Bakiye
GET  /v1/wallet/summary           Özet
GET  /v1/wallet/transactions      İşlem geçmişi
GET  /v1/wallet/estimate          Maliyet tahmini
GET  /v1/wallet/can-afford        Bakiye yeter mi
POST /v1/wallet/topup             Bakiye yükleme başlat
GET  /v1/payments/history         Ödeme geçmişi
PUT  /v1/payments/auto-charge     Otomatik tahsilat ayarı

Kimlik istemeyen açık uçlar

GET  /v1/pricing                  Güncel fiyat listesi
GET  /v1/branding/{domain}        Marka görünümü sorgusu
POST /v1/contact                  İletişim formu
POST /v1/newsletter/subscribe     Bülten kaydı
POST /v1/events                   İstemci tarafı olay girişi
POST /v1/demo/*                   Demo araması (hız sınırlı)

Açık uçlar kimlik doğrulaması istemez ama IP başına hız sınırına tabidir — kötüye kullanımı önlemek için sınır düşük tutulur.

OpenAPI şeması

Tüm uçların makine okunur şeması tek bir dosyadan yayınlanır. Postman’e aktarabilir, istediğiniz dilde istemci üretebilir veya şemayı doğrudan okuyabilirsiniz.

curl https://api.call2me.app/openapi.json -o call2me-openapi.json

Hız sınırları

• Kimlik doğrulanmış uçlarda anahtar başına dakikada istek sınırı vardır (varsayılan yüksek, üst sınır ayarlanabilir).
• Açık uçlarda sınır IP başınadır ve daha sıkıdır.
• Sınır aşıldığında 429 ve Retry-After başlığı döner.