Crea chiamate, messaggistica e AI con l'api di Acepeak.
Endpoint REST, webhook in tempo reale e SDK di prima classe. Autentica l'api con un bearer access token e invia la tua prima richiesta in meno di cinque minuti.
# 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"}'Quickstart.
- 01passo
Ottieni un access token
Accedi alla dashboard di Acepeak, apri Developers → Tokens e crea un nuovo bearer token. I token hanno uno scope per ambiente (sandbox o live) e sono rotabili dalla dashboard in qualsiasi momento.
Attenzione — mantieni i token live lato server. Qualsiasi cosa tocchi un browser dovrebbe passare attraverso il tuo backend.
- 02passo
Autenticati
Ogni richiesta usa l'autenticazione con bearer token nell'header Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03passo
Invia la tua prima richiesta
Effettua una chiamata, invia un SMS o elenca i tuoi numeri — scegli ciò che si adatta al tuo caso d'uso. Dovresti vedere un elenco JSON dei tuoi numeri di telefono. Da lì puoi effettuare chiamate, inviare SMS, configurare i webhook e iniziare a sviluppare.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Ogni funzionalità della piattaforma è esposta tramite REST.
Chiamate vocali
Effettua chiamate in uscita, gestisci le chiamate in entrata, trasferisci, fai conferenze, registra, trascrivi. Flussi answer-URL programmabili, acquisizione DTMF in chiamata, streaming in tempo reale.
/v1/calls/v1/conferences/v1/recordingsMessaggistica (SMS e MMS)
Invia e ricevi su numeri US 10DLC, numero verde e short-code. Bidirezionale, conferme di consegna, conformità all'opt-out, messaggi lunghi concatenati.
/v1/messages/v1/messages/inboundNumeri di telefono
Cerca, acquista, porta e rilascia. DID locali US, numero verde e internazionali in oltre 60 Paesi.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtenti e team
Crea utenti, assegna ruoli, gestisci team, configura l'SSO. SCIM 2.0 per la gestione automatizzata del ciclo di vita con il tuo IdP.
/v1/users/v1/teams/v1/ssoWebhook
Consegna in tempo reale degli eventi di chiamata, messaggio e registrazione al tuo endpoint. Firmati con HMAC-SHA256, ritentati con backoff esponenziale per 24h.
/v1/webhooks/v1/webhooks/{id}/eventsSuperfici AI
Attiva l'AI Receptionist, estrai le trascrizioni, recupera i punteggi di sentiment per chiamata o per chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentModi per autenticarti.
Autenticazione con access token
Consigliata per i servizi backend. Bearer token inviato in ogni richiesta. I token sono ambito per ambiente, ruotabili dalla dashboard e legati a un ruolo specifico per un accesso a privilegi minimi.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Per le app partner e le integrazioni del marketplace. Authorization Code grant con PKCE. Usalo quando la tua app agisce per conto di un cliente anziché del tuo account.
- Authorization Code + PKCE
- Refresh token · 30 giorni di default
- Ambito per cliente
Prevedibili, documentati, e mai silenziosi.
Rate limit
Default: 100 r/s per access token. Picchi fino a 200 r/s per brevi finestre. Al superamento, la piattaforma restituisce 429 con un header Retry-After.
Idempotenza
Le richieste di modifica supportano un Idempotency-Key header. Usalo nelle richieste POST, PUT e DELETE così i retry non causano doppi addebiti o doppi invii.
Codici di errore
400Richiesta non validaValidazione fallita401Non autorizzatoToken di accesso non valido o mancante403VietatoIl token non ha lo scope necessario404Non trovatoRisorsa non trovata409ConflittoMancata corrispondenza di idempotenza o stato429Limite di frequenza raggiuntoRallenta — fornito Retry-After5xxLato serverRiprova con backoff esponenziale
Eventi in tempo reale consegnati al tuo endpoint.
Sottoscrivi un endpoint HTTPS per gli eventi di chiamata, messaggio e registrazione. I webhook sono firmati con HMAC-SHA256 — verifica la firma prima di elaborare. Le consegne fallite vengono ritentate con backoff esponenziale fino a 24 ore. Puoi riprodurre qualsiasi evento dalla dashboard.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Librerie di prima classe, mappate specularmente al REST.
URL stabili. Aggiornamenti prevedibili.
Le versioni dell'interfaccia sono fissate nell'URL (/v1/). Le modifiche che rompono la compatibilità arrivano dietro una nuova versione major. Le aggiunte non incompatibili arrivano sulla stessa versione con una nota di rilascio nel changelog per sviluppatori.
Le funzionalità restano attive per 12 mesi dopo un avviso di deprecazione. Inviamo un'email a ogni team con un access token attivo a 90, 30 e 7 giorni prima della scadenza — nessuna sorpresa in produzione.
Pronto a iniziare a costruire?
Domande, con risposta.
È un'interfaccia REST più webhook firmati che espone chiamate vocali, SMS / MMS, numeri di telefono, utenti e superfici AI. Autenticati con un bearer access token, raggiungi gli endpoint documentati e vai in produzione in pochi minuti.
Costruisci sull'API, rilascia lo stesso giorno.
Supporto 24/7 incluso. Numeri portati da qualsiasi operatore nel mondo.