REST API

Calleague REST API'si, panoda yaptıklarınızı koddan yapmanızı sağlar: sesli asistanlarınızı çalıştırın, çağrı başlatıp inceleyin ve hesabınızın verilerini okuyun. Bu sayfa temel adresi, Bearer kimlik doğrulamayı, sık kullanılan işlemleri, sayfalamayı, hata kodlarını ve hız sınırlarını kapsar — hepsi ekran görüntüsündeki gerçek istek ve yanıt çevresinde.

Buradaki her şey uygulama düzeyindedir: çalışma alanınız olarak giriş yapar ve güvenli bir bağlantı üzerinden istek gönderirsiniz. Kurulacak hiçbir şey yoktur.

Bir bakışta

Temel adres

Tüm istekler, https://app.calleague.ai/api/... ile başlayarak Calleague çalışma alanınıza gider. İstekler ve yanıtlar JSON biçimindedir. Gövde gönderen her isteğe Content-Type: application/json ekleyin.

Kimlik doğrulama

Her istek, standart Authorization başlığında Bearer token olarak bir API anahtarı taşır — ekran görüntüsünde gördüğünüz Authorization: Bearer $TOKEN satırının aynısı:

Authorization: Bearer $TOKEN

Anahtarları uygulamadaki hesap ayarlarınızdan oluşturur, adlandırır ve iptal edersiniz. Bir anahtar sizin izinlerinizi devralır; yani yapabildiğinizi yapar, fazlasını değil.

curl -s https://app.calleague.ai/api/core/voice/agent/list \
  -H "Authorization: Bearer $TOKEN"

Sık kullanılan işlemler

İlk satır ekran görüntüsündeki gerçek uç noktadır. Geri kalanlar başvuracağınız tamamlayıcı işlemlerdir; tam yollarını örnek kabul edin ve çalışma alanınız için doğrulayın.

İstek alanları — çağrı başlatma

Sorgu alanları — çağrıları listeleme

Çağrı başlatma

Bu, ekran görüntüsündeki istek ve yanıtın aynısıdır. Kendi referansınızı (örneğin bir sipariş kimliği) taşımak için isteğe bağlı bir metadata nesnesi ekleyin.

curl -s -X POST https://app.calleague.ai/api/core/voice/agent/call \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "agentId": "ag_123",
        "to": "+90312...",
        "metadata": { "orderId": "A-1042" }
      }'

Başarılı bir başlatma yeni çağrıyı döndürür:

{
  "callId": "cl_8f2a",
  "status": "ringing",
  "language": "tr"
}

Bir çağrıyı arayıp bulma

Nasıl ilerlediğini görmek için tek bir çağrıyı okuyun — ya da bunun yerine haberdar edilmek için webhook'lara güvenin.

curl -s https://app.calleague.ai/api/core/voice/call/cl_8f2a \
  -H "Authorization: Bearer $TOKEN"

{
  "callId": "cl_8f2a",
  "status": "completed",
  "direction": "outbound",
  "durationSec": 84,
  "endedReason": "completed",
  "language": "tr",
  "recordingReady": true,
  "transcriptReady": true,
  "createdAt": "2026-01-01T12:00:00.000Z",
  "endedAt": "2026-01-01T12:01:24.000Z"
}

Çağrı durum değerleri

Sayfalama

Çağrıları listelemek sayfalı bir yapı döndürür — boş bir listeyi her zaman zarifçe ele alın:

curl -s "https://app.calleague.ai/api/core/voice/call/list?page=1&pageSize=20" \
  -H "Authorization: Bearer $TOKEN"

{
  "total": 0,
  "list": []
}

Sonuçlar arasında ilerlemek için, topladığınız öğe sayısı total değerine ulaşana kadar page'i artırın.

Hata kodları

Başarısız bir istek; 2xx olmayan bir durum, bir code ve okunabilir bir message ile geri döner. Önce HTTP durumuna göre dallanın.

{
  "code": 401,
  "message": "Invalid or missing API key"
}

Hız sınırları

API, çalışma alanı başına adil kullanım sınırları uygular. İstemcinizi buna dayanacak şekilde kurun:

Bir şey farklı görünüyorsa

Sık sorulan sorular

Sırada ne var