Bouw bellen, messaging en AI op de Acepeak-api.
REST-endpoints, realtime webhooks en first-class SDK's. Authenticeer de api met een bearer access token en verstuur uw eerste verzoek binnen vijf minuten.
# 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.
- 01stap
Verkrijg een access token
Log in op het Acepeak-dashboard, open Developers → Tokens en maak een nieuw bearer token aan. Tokens zijn gescoped per omgeving (sandbox of live) en op elk moment roteerbaar vanuit het dashboard.
Let op — houd live tokens server-side. Alles wat een browser raakt, moet via uw backend lopen.
- 02stap
Authenticeren
Elk verzoek gebruikt bearer-token-authenticatie in de Authorization-header.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03stap
Verstuur uw eerste verzoek
Plaats een gesprek, verstuur een SMS of toon uw nummers — kies wat bij uw use case past. U zou een JSON-lijst van uw telefoonnummers moeten zien. Vanaf daar kunt u gesprekken plaatsen, SMS versturen, webhooks instellen en beginnen met bouwen.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Elke functionaliteit in het platform is ontsloten via REST.
Spraakgesprekken
Plaats uitgaande gesprekken, beheer inkomende gesprekken, verbind door, schakel conference in, neem op, transcribeer. Programmeerbare answer-URL-flows, DTMF-capture tijdens het gesprek, realtime streaming.
/v1/calls/v1/conferences/v1/recordingsMessaging (SMS & MMS)
Verstuur en ontvang op Amerikaanse 10DLC-, gratis- en shortcode-nummers. Tweerichting, afleverbevestigingen, opt-out-compliance, samengevoegde lange berichten.
/v1/messages/v1/messages/inboundTelefoonnummers
Zoek, koop, porteer en geef vrij. Lokale Amerikaanse, gratis en internationale DIDs in 60+ landen.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersGebruikers & teams
Voorzie gebruikers, wijs rollen toe, beheer teams, configureer SSO. SCIM 2.0 voor geautomatiseerd lifecyclebeheer met uw IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Realtime bezorging van gesprek-, bericht- en opnamegebeurtenissen naar uw endpoint. HMAC-SHA256-ondertekend, opnieuw geprobeerd met exponential backoff gedurende 24u.
/v1/webhooks/v1/webhooks/{id}/eventsAI-onderdelen
Trigger de AI Receptionist, haal transcripties op, haal sentimentscores op per gesprek of per chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentManieren om te authenticeren.
Authenticatie met access token
Aanbevolen voor backendservices. Bearer-token wordt bij elk verzoek meegestuurd. Tokens hebben een scope per omgeving, zijn roteerbaar vanuit het dashboard en gekoppeld aan een specifieke rol voor toegang volgens het least-privilege-principe.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Voor partner-apps en marketplace-integraties. Authorization Code-grant met PKCE. Gebruik dit wanneer uw app namens een klant handelt in plaats van namens uw eigen account.
- Authorization Code + PKCE
- Refresh-tokens · 30 dagen standaard
- Scope per klant
Voorspelbaar, gedocumenteerd, en nooit stilzwijgend.
Rate limits
Standaard: 100 r/s per access token. Bursts tot 200 r/s voor korte vensters. Bij overschrijding geeft het platform 429 terug met een Retry-After-header.
Idempotentie
Muterende verzoeken ondersteunen een Idempotency-Key header. Gebruik deze bij POST-, PUT- en DELETE-verzoeken zodat retries niet dubbel afrekenen of dubbel versturen.
Foutcodes
400Ongeldig verzoekValidatie mislukt401Niet geautoriseerdOngeldig of ontbrekend access token403VerbodenToken heeft niet de juiste scope404Niet gevondenResource niet gevonden409ConflictIdempotentie- of statusconflict429Rate limitedVertraag — Retry-After meegegeven5xxServer-sideProbeer opnieuw met exponential backoff
Realtime-events afgeleverd op uw endpoint.
Abonneer een HTTPS-endpoint op gespreks-, bericht- en opname-events. Webhooks zijn ondertekend met HMAC-SHA256 — verifieer de handtekening voordat u verwerkt. Mislukte afleveringen worden tot 24 uur opnieuw geprobeerd met exponential backoff. U kunt elk event opnieuw afspelen vanuit het dashboard.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}First-class libraries, één-op-één gemapt op REST.
Stabiele URL's. Voorspelbare upgrades.
Interfaceversies zijn vastgepind in de URL (/v1/). Breaking changes verschijnen achter een nieuwe major versie. Niet-brekende toevoegingen komen op dezelfde versie met een release-notitie in de developer-changelog.
Functies blijven actief gedurende 12 maanden na een deprecation-melding. We e-mailen elk team met een actief access token op 90, 30 en 7 dagen vóór de deadline — geen verrassingen in productie.
Klaar om te beginnen met bouwen?
Vragen, beantwoord.
Het is een REST-interface plus ondertekende webhooks die spraakbellen, SMS / MMS, telefoonnummers, gebruikers en AI-onderdelen ontsluit. Authenticeer met een bearer access token, benader de gedocumenteerde endpoints en ga binnen enkele minuten live.
Bouw op de API, lever nog dezelfde dag op.
24/7 support inbegrepen. Nummers geporteerd vanaf elke carrier wereldwijd.