Skip to main content
Acepeak
Geliştiriciler

Arama, mesajlaşma ve AI oluşturun Acepeak api üzerinde.

REST uç noktaları, gerçek zamanlı webhook'lar ve birinci sınıf SDK'ler. api'yi bir taşıyıcı erişim belirteciyle kimlik doğrulayın ve ilk isteğinizi beş dakikadan kısa sürede gönderin.

place-call.sh
# Place a call from a US number
curl -X POST https://endpoints.acepeak.com/v1/calls \
  -H "Authorization: Bearer $ACEPEAK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"+18005551212",
       "to":"+14155551212",
       "answer_url":"https://your.app/answer"}'
İlk çağrınıza beş dakika

Hızlı başlangıç.

  1. 01adım

    Bir erişim belirteci alın

    Acepeak panosunda oturum açın, Developers → Tokens'ı açın ve yeni bir taşıyıcı belirteç oluşturun. Belirteçler ortam başına (sandbox veya canlı) kapsamlandırılır ve panodan istediğiniz zaman döndürülebilir.

    Dikkat — canlı belirteçleri sunucu tarafında tutun. Bir tarayıcıya dokunan her şey arka ucunuzdan geçmelidir.

  2. 02adım

    Kimlik doğrulayın

    Her istek, Authorization başlığında taşıyıcı belirteç kimlik doğrulaması kullanır.

    Authorization: Bearer YOUR_ACEPEAK_TOKEN
  3. 03adım

    İlk isteğinizi gönderin

    Bir çağrı yapın, bir SMS gönderin veya numaralarınızı listeleyin — kullanım durumunuza uyanı seçin. Telefon numaralarınızın bir JSON listesini görmelisiniz. Oradan çağrılar yapabilir, SMS gönderebilir, webhook'lar kurabilir ve geliştirmeye başlayabilirsiniz.

    curl https://endpoints.acepeak.com/v1/numbers \
      -H "Authorization: Bearer $ACEPEAK_TOKEN"
Neler oluşturabilirsiniz

Platformdaki her yetenek REST aracılığıyla açığa çıkarılır.

Sesli çağrılar

Giden çağrılar yapın, gelen çağrıları kontrol edin, aktarın, konferans yapın, kaydedin, transkript çıkarın. Programlanabilir answer-URL akışları, çağrı içi DTMF yakalama, gerçek zamanlı akış.

/v1/calls/v1/conferences/v1/recordings

Mesajlaşma (SMS ve MMS)

ABD 10DLC, ücretsiz hat ve kısa kod numaralarında gönderin ve alın. İki yönlü, teslim makbuzları, çıkış uyumluluğu, birleştirilmiş uzun mesajlar.

/v1/messages/v1/messages/inbound

Telefon numaraları

Arayın, satın alın, taşıyın ve serbest bırakın. 60+ ülkede yerel ABD, ücretsiz hat ve uluslararası DID'ler.

/v1/numbers/v1/numbers/available/v1/numbers/port-orders

Kullanıcılar ve Ekipler

Kullanıcıları sağlayın, rolleri atayın, ekipleri yönetin, SSO yapılandırın. IdP'nizle otomatik yaşam döngüsü yönetimi için SCIM 2.0.

/v1/users/v1/teams/v1/sso

Webhooks

Çağrı, mesaj ve kayıt olaylarının uç noktanıza gerçek zamanlı teslimi. HMAC-SHA256 imzalı, 24 saat boyunca üstel geri çekilmeyle yeniden denenir.

/v1/webhooks/v1/webhooks/{id}/events

AI yüzeyleri

AI Receptionist'i tetikleyin, transkriptleri çekin, çağrı veya sohbet başına duygu puanlarını getirin.

/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment
Kimlik doğrulama

Yöntemler kimlik doğrulamak için.

Erişim belirteci kimlik doğrulaması

Arka uç hizmetleri için önerilir. Her istekte taşıyıcı belirteç gönderilir. Belirteçler ortam başına kapsamlandırılır, panodan döndürülebilir ve en az ayrıcalıklı erişim için belirli bir role bağlanır.

Authorization: Bearer YOUR_ACEPEAK_TOKEN

OAuth 2.0

Partner uygulamaları ve pazar yeri entegrasyonları için. PKCE ile Authorization Code izni. Uygulamanız kendi hesabınız yerine bir müşteri adına işlem yaptığında bunu kullanın.

  • Authorization Code + PKCE
  • Yenileme belirteçleri · 30 günlük varsayılan
  • Müşteri başına kapsamlandırma
Hız sınırları ve hatalar

Öngörülebilir, belgelenmiş, ve asla sessiz değil.

Hız sınırları

Varsayılan: 100 r/s erişim belirteci başına. Şuna kadar ani artışlar: 200 r/s kısa pencereler için. Aşıldığında, platform Retry-After başlığıyla 429 döndürür.

Eşgüçlülük

Değişiklik yapan istekler şunu destekler: Idempotency-Key başlığı. Yeniden denemelerin çift ücretlendirme veya çift gönderim yapmaması için POST, PUT ve DELETE isteklerinde kullanın.

Hata kodları

  • 400Hatalı istekDoğrulama başarısız
  • 401YetkisizGeçersiz veya eksik erişim belirteci
  • 403YasakBelirtecin kapsamı yok
  • 404BulunamadıKaynak bulunamadı
  • 409ÇakışmaEşgüçlülük veya durum uyuşmazlığı
  • 429Hız sınırlıYavaşlayın — Retry-After sağlandı
  • 5xxSunucu tarafıÜstel geri çekilmeyle yeniden deneyin
Webhooks

Gerçek zamanlı olaylar uç noktanıza teslim edilir.

Bir HTTPS uç noktasını çağrı, mesaj ve kayıt olaylarına abone edin. Webhook'lar HMAC-SHA256 ile imzalanır — işlemeden önce imzayı doğrulayın. Başarısız teslimatlar, 24 saate kadar üstel geri çekilmeyle yeniden denenir. Herhangi bir olayı panodan yeniden oynatabilirsiniz.

POST · /your-webhookSigned
{
  "id": "evt_01HW3...",
  "type": "call.completed",
  "created_at": "2026-04-30T10:42:00Z",
  "data": {
    "call_id": "CA_01HW...",
    "duration_sec": 184
  }
}
HMAC-SHA256 imzalı · yeniden oynatmaya güvenli
24 saat üstel geri çekilmeli yeniden denemeler
Herhangi bir olayı panodan yeniden oynatın
Olay türüne göre filtreleyin · uç nokta başına
SDK'ler

Birinci sınıf kitaplıklar, REST'e yansıtmalı eşlenir.

Node.jsnpm install @acepeak/sdkYükle
Pythonpip install acepeakYükle
PHPcomposer require acepeak/sdkYükle
Gogo get github.com/acepeak/acepeak-goYükle
Rubygem install acepeakYükle
MIT lisanslı · platformla aynı sürüm temposuPostman →
Sürümleme

Kararlı URL'ler. Öngörülebilir yükseltmeler.

Arayüz sürümleri URL'de sabitlenir (/v1/). Bozucu değişiklikler yeni bir ana sürümün ardında sunulur. Bozucu olmayan eklemeler, geliştirici değişiklik günlüğünde bir sürüm notuyla aynı sürümde gelir.

Kullanımdan kaldırma politikası

Özellikler şu süre boyunca canlı kalır: 12 ay bir kullanımdan kaldırma bildirimi sonrasında. Etkin erişim belirtecine sahip her ekibe şu zamanlarda e-posta göndeririz: 90, 30 ve 7 gün kesim tarihinden önce — üretimde sürpriz yok.

Geliştirmeye başlamaya hazır mısınız?

SSS

Sorular, yanıtlandı.

Sesli arama, SMS / MMS, telefon numaraları, kullanıcılar ve AI yüzeylerini açığa çıkaran bir REST arayüzü ile imzalı webhook'lardır. Bir taşıyıcı erişim belirteciyle kimlik doğrulayın, belgelenen uç noktalara erişin ve dakikalar içinde yayına alın.

REST · webhook'lar · SDK'ler

api üzerinde geliştirin, aynı gün yayına alın.

24/7 destek dahildir. Numaralar dünya çapında herhangi bir operatörden taşınır.

24/7 destek60+ ülkeSOC 2 IISandbox konsolu
Son güncelleme: Mayıs 2026