Construiește apeluri, mesagerie și AI pe api-ul Acepeak.
Endpointuri REST, webhook-uri în timp real și SDK-uri de primă clasă. Autentifică api-ul cu un token de acces bearer și trimite prima ta cerere în mai puțin de cinci minute.
# 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"}'Ghid rapid.
- 01pas
Obține un token de acces
Conectează-te la tabloul de bord Acepeak, deschide Developers → Tokens și creează un nou token bearer. Tokenurile au domeniu per mediu (sandbox sau live) și pot fi rotite din tabloul de bord oricând.
Atenție — păstrează tokenurile live pe partea de server. Orice ajunge la un browser ar trebui să treacă prin backendul tău.
- 02pas
Autentifică-te
Fiecare cerere folosește autentificare cu token bearer în antetul Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03pas
Trimite prima ta cerere
Inițiază un apel, trimite un SMS sau listează-ți numerele — alege ce se potrivește cazului tău de utilizare. Ar trebui să vezi o listă JSON cu numerele tale de telefon. De acolo, poți iniția apeluri, trimite SMS, configura webhook-uri și începe să construiești.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Fiecare capabilitate din platformă este expusă prin REST.
Apeluri vocale
Inițiază apeluri outbound, controlează apelurile primite, transferă, organizează conferințe, înregistrează, transcrie. Fluxuri programabile answer-URL, captare DTMF în apel, streaming în timp real.
/v1/calls/v1/conferences/v1/recordingsMesagerie (SMS și MMS)
Trimite și primește pe numere 10DLC, toll-free și short-code din SUA. Bidirecțional, confirmări de livrare, conformitate opt-out, mesaje lungi concatenate.
/v1/messages/v1/messages/inboundNumere de telefon
Caută, cumpără, portează și eliberează. DID-uri locale din SUA, toll-free și internaționale în peste 60 de țări.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtilizatori și echipe
Creează utilizatori, atribuie roluri, gestionează echipe, configurează SSO. SCIM 2.0 pentru gestionarea automată a ciclului de viață cu IdP-ul tău.
/v1/users/v1/teams/v1/ssoWebhooks
Livrare în timp real a evenimentelor de apel, mesaj și înregistrare către endpointul tău. Semnate HMAC-SHA256, reîncercate cu backoff exponențial timp de 24h.
/v1/webhooks/v1/webhooks/{id}/eventsSuprafețe AI
Declanșează AI Receptionist, extrage transcrieri, preia scoruri de sentiment per apel sau per chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentModalități de autentificare.
Autentificare cu token de acces
Recomandat pentru servicii backend. Token bearer trimis în fiecare cerere. Tokenurile au domeniu per mediu, pot fi rotite din tabloul de bord și sunt legate de un rol specific pentru acces cu privilegii minime.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Pentru aplicații partenere și integrări de tip marketplace. Acordare Authorization Code cu PKCE. Folosește această variantă când aplicația ta acționează în numele unui client, nu al propriului tău cont.
- Authorization Code + PKCE
- Tokenuri de reîmprospătare · 30 de zile implicit
- Domeniu per client
Predictibile, documentate și niciodată tăcute.
Limite de rată
Implicit: 100 r/s per token de acces. Vârfuri de până la 200 r/s pentru perioade scurte. La depășire, platforma returnează 429 cu un antet Retry-After.
Idempotență
Cererile care modifică date acceptă un antet Idempotency-Key . Folosește-l pe cererile POST, PUT și DELETE astfel încât reîncercările să nu factureze sau să nu trimită de două ori.
Coduri de eroare
400Cerere invalidăValidarea a eșuat401NeautorizatToken de acces invalid sau lipsă403InterzisTokenul nu are domeniul necesar404NegăsitResursă negăsită409ConflictNeconcordanță de idempotență sau de stare429Limitat ca ratăÎncetinește — Retry-After furnizat5xxPe partea de serverReîncearcă cu backoff exponențial
Evenimente în timp real livrate către endpointul tău.
Abonează un endpoint HTTPS la evenimente de apel, mesaj și înregistrare. Webhook-urile sunt semnate cu HMAC-SHA256 — verifică semnătura înainte de procesare. Livrările eșuate sunt reîncercate cu backoff exponențial timp de până la 24 de ore. Poți relua orice eveniment din tabloul de bord.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Biblioteci de primă clasă, mapate fidel pe REST.
URL-uri stabile. Upgrade-uri predictibile.
Versiunile interfeței sunt fixate în URL (/v1/). Modificările incompatibile sunt livrate sub o nouă versiune majoră. Adăugirile compatibile ajung pe aceeași versiune cu o notă de lansare în changelogul pentru dezvoltatori.
Funcțiile rămân active timp de 12 luni după o notificare de retragere. Trimitem e-mailuri fiecărei echipe cu un token de acces activ cu 90, 30 și 7 zile înainte de termenul limită — fără surprize în producție.
Gata să începi să construiești?
Întrebări, cu răspuns.
Este o interfață REST plus webhook-uri semnate care expune apeluri vocale, SMS / MMS, numere de telefon, utilizatori și suprafețe AI. Autentifică-te cu un token de acces bearer, accesează endpointurile documentate și livrează în câteva minute.
Construiește pe api, livrează în aceeași zi.
Asistență 24/7 inclusă. Numere portate de la orice operator din lume.