Sviluppa chiamate, messaggistica e intelligenza artificiale sull'API Acepeak.
Endpoint REST, webhook in tempo reale e SDK di prima classe. Autentica l'API con un token di accesso al portatore 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"}'Avvio rapido.
- 01fare un passo
Ottieni un token di accesso
Accedi alla dashboard di Acepeak, apri Sviluppatori → Token e crea un nuovo token al portatore. I token hanno un ambito per ambiente (sandbox o live) e possono essere ruotati dalla dashboard in qualsiasi momento.
Attenzione: mantieni i token attivi sul lato server. Tutto ciò che tocca un browser dovrebbe passare attraverso il tuo backend.
- 02fare un passo
Autenticare
Ogni richiesta utilizza l'autenticazione del token di connessione nell'intestazione Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03fare un passo
Invia la tua prima richiesta
Effettua una chiamata, invia un SMS o elenca i tuoi numeri: scegli quello più adatto al tuo caso d'uso. Dovresti vedere un elenco JSON dei tuoi numeri di telefono. Da lì puoi effettuare chiamate, inviare SMS, configurare webhook e iniziare a creare.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Tutte le funzionalità della piattaforma viene esposto tramite REST.
Chiamate vocali
Effettua chiamate in uscita, controlla le chiamate in entrata, trasferisci, fai conferenze, registra, trascrivi. Flussi di URL di risposta programmabili, acquisizione DTMF in chiamata, streaming in tempo reale.
/v1/calls/v1/conferences/v1/recordingsMessaggistica (SMS e MMS)
Invia e ricevi su numeri DLC 10 statunitensi, numeri verdi e codici brevi. Bidirezionale, ricevute di consegna, conformità opt-out, messaggi lunghi concatenati.
/v1/messages/v1/messages/inboundNumeri di telefono
Cerca, acquista, trasferisci e rilascia. DID locali negli Stati Uniti, numeri verdi e internazionali in oltre 60 paesi.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtenti e team
Effettua il provisioning degli utenti, assegna ruoli, gestisci i team, configura 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 di chiamate, messaggi ed eventi di registrazione al tuo endpoint. HMAC-SHA256 firmato, riprovato con backoff esponenziale per 24 ore.
/v1/webhooks/v1/webhooks/{id}/eventsSuperfici dell'intelligenza artificiale
Attiva l'addetto alla reception AI, recupera le trascrizioni, recupera i punteggi dei sentimenti per chiamata o chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentModi per autenticare.
Autenticazione token di accesso
Consigliato per i servizi di backend. Token al portatore inviato in ogni richiesta. I token hanno un ambito per ambiente, possono essere ruotati dalla dashboard e legati a un ruolo specifico per l'accesso con privilegi minimi.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Per le app dei partner e le integrazioni del marketplace. Concessione del codice di autorizzazione con PKCE. Utilizzalo quando la tua app agisce per conto di un cliente anziché per conto del tuo account.
- Codice di autorizzazione + PKCE
- Aggiorna token · Impostazione predefinita a 30 giorni
- Ambito per cliente
Prevedibile, documentato, e mai silenzioso.
Limiti di tariffa
Predefinito: 100 giri/s per token di accesso. Scoppia fino a 200 giri/s per finestre corte. Quando viene superato, la piattaforma restituisce 429 con un'intestazione Retry-After.
Idempotenza
Le richieste mutanti supportano un Idempotency-Key intestazione. Usalo su richieste POST, PUT e DELETE in modo che i nuovi tentativi non vengano addebitati o inviati due volte.
Codici di errore
400Brutta richiestaConvalida non riuscita401Non autorizzatoToken di accesso non valido o mancante403VietatoIl token non ha ambito404Non trovatoRisorsa non trovata409ConflittoIdempotenza o mancata corrispondenza dello stato429Tariffa limitataRallenta: riprova dopo fornito5xxLato serverRiprova con backoff esponenziale
Eventi in tempo reale consegnato al tuo endpoint.
Sottoscrivi un endpoint HTTPS per chiamare, inviare messaggi e registrare eventi. I webhook sono firmati con HMAC-SHA256: verifica la firma prima dell'elaborazione. Le consegne non riuscite 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
}
}Biblioteche di prima classe, mappato in mirroring su REST.
URL stabili. Aggiornamenti prevedibili.
Le versioni dell'interfaccia sono bloccate nell'URL (/v1/). Le modifiche importanti vengono fornite dietro una nuova versione principale. Le aggiunte non significative arrivano sulla stessa versione con una nota di rilascio nel registro delle modifiche dello sviluppatore.
Le funzionalità restano attive 12 mesi dopo un avviso di deprezzamento. Inviamo un'e-mail a ogni team con un token di accesso attivo all'indirizzo 90, 30 e 7 giorni prima della chiusura: nessuna sorpresa nella produzione.
Pronto per iniziare a costruire?
Domande, rispose.
Si tratta di un'interfaccia REST più webhook firmati che espone chiamate vocali, SMS/MMS, numeri di telefono, utenti e superfici AI. Autenticati con un token di accesso al portatore, raggiungi gli endpoint documentati e spedisci in pochi minuti.
Costruisci sull'API, spedire lo stesso giorno.
Supporto 24 ore su 24, 7 giorni su 7 incluso. Numeri trasferiti da qualsiasi operatore in tutto il mondo.