Erstellen Sie Anrufe, Nachrichten und KI auf der Acepeak-API.
REST-Endpunkte, Echtzeit-Webhooks und erstklassige SDKs. Authentifizieren Sie die API mit einem Bearer-Zugriffstoken und senden Sie Ihre erste Anfrage in weniger als fünf 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"}'Schnellstart.
- 01Schritt
Holen Sie sich ein Zugriffstoken
Melden Sie sich beim Acepeak-Dashboard an, öffnen Sie Entwickler → Token und erstellen Sie einen neuen Inhaber-Token. Tokens sind je nach Umgebung (Sandbox oder Live) gültig und können jederzeit über das Dashboard geändert werden.
Achtung – behalten Sie die Live-Token serverseitig bei. Alles, was einen Browser berührt, sollte über Ihr Backend laufen.
- 02Schritt
Authentifizieren
Jede Anfrage verwendet die Bearer-Token-Authentifizierung im Autorisierungsheader.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03Schritt
Senden Sie Ihre erste Anfrage
Tätigen Sie einen Anruf, senden Sie eine SMS oder listen Sie Ihre Nummern auf – wählen Sie, was zu Ihrem Anwendungsfall passt. Sie sollten eine JSON-Liste Ihrer Telefonnummern sehen. Von dort aus können Sie Anrufe tätigen, SMS senden, Webhooks einrichten und mit dem Aufbau beginnen.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Alle Funktionen der Plattform wird über REST verfügbar gemacht.
Sprachanrufe
Ausgehende Anrufe tätigen, eingehende Anrufe steuern, weiterleiten, Konferenzen durchführen, aufzeichnen und transkribieren. Programmierbare Antwort-URL-Abläufe, DTMF-Erfassung während des Anrufs, Echtzeit-Streaming.
/v1/calls/v1/conferences/v1/recordingsNachrichten (SMS und MMS)
Senden und empfangen Sie über US 10DLC, gebührenfreie Nummern und Kurzwahlnummern. Bidirektional, Zustellungsbestätigungen, Opt-out-Compliance, verkettete lange Nachrichten.
/v1/messages/v1/messages/inboundTelefonnummern
Suchen, kaufen, portieren und freigeben. Lokale US-amerikanische, gebührenfreie und internationale DIDs in über 60 Ländern.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersBenutzer und Teams
Benutzer bereitstellen, Rollen zuweisen, Teams verwalten, SSO konfigurieren. SCIM 2.0 für automatisiertes Lebenszyklusmanagement mit Ihrem IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Echtzeitübermittlung von Anrufen, Nachrichten und Aufzeichnungsereignissen an Ihren Endpunkt. HMAC-SHA256 signiert, erneuter Versuch mit exponentiellem Backoff für 24 Stunden.
/v1/webhooks/v1/webhooks/{id}/eventsKI taucht auf
Lösen Sie den KI-Rezeptionisten aus, rufen Sie Transkripte ab und rufen Sie Sentiment-Scores pro Anruf oder pro Chat ab.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentWege zu authentifizieren.
Zugriffstoken-Authentifizierung
Empfohlen für Backend-Dienste. Bei jeder Anfrage wird ein Inhabertoken gesendet. Tokens sind je nach Umgebung gültig, können über das Dashboard gedreht werden und sind für den Zugriff mit den geringsten Rechten an eine bestimmte Rolle gebunden.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Für Partner-Apps und Marktplatz-Integrationen. Erteilung eines Autorisierungscodes mit PKCE. Verwenden Sie dies, wenn Ihre App im Namen eines Kunden und nicht Ihres eigenen Kontos agiert.
- Autorisierungscode + PKCE
- Aktualisierungstoken · 30-Tage-Standardeinstellung
- Scoping pro Kunde
Vorhersehbar, dokumentiert, und niemals still.
Tarifbegrenzungen
Standard: 100 U/s pro Zugriffstoken. Platzt bis zu 200 U/s für kurze Fenster. Bei Überschreitung gibt die Plattform 429 mit einem Retry-After-Header zurück.
Idempotenz
Mutierende Anfragen unterstützen ein Idempotency-Key Kopfzeile. Verwenden Sie es für POST-, PUT- und DELETE-Anfragen, damit bei Wiederholungsversuchen keine doppelten Gebühren oder doppelten Sendungen entstehen.
Fehlercodes
400Ungültige AnforderungDie Validierung ist fehlgeschlagen401Nicht autorisiertUngültiges oder fehlendes Zugriffstoken403VerbotenToken hat keinen Gültigkeitsbereich404Nicht gefundenRessource nicht gefunden409KonfliktIdempotenz oder Zustandsinkongruenz429Preis begrenztVerlangsamen – Retry-After bereitgestellt5xxServerseitigVersuchen Sie es erneut mit exponentiellem Backoff
Echtzeitereignisse an Ihren Endpunkt geliefert.
Abonnieren Sie einen HTTPS-Endpunkt für Anruf-, Nachrichten- und Aufzeichnungsereignisse. Webhooks werden mit HMAC-SHA256 signiert – überprüfen Sie die Signatur vor der Verarbeitung. Fehlgeschlagene Lieferungen werden mit exponentiellem Backoff für bis zu 24 Stunden wiederholt. Sie können jedes Ereignis über das Dashboard wiedergeben.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Erstklassige Bibliotheken, gespiegelt auf REST abgebildet.
Stabile URLs. Vorhersehbare Upgrades.
Schnittstellenversionen sind in der URL angeheftet (/v1/). Breaking Changes werden hinter einer neuen Hauptversion veröffentlicht. Nicht-unterbrechende Ergänzungen kommen in derselben Version mit einem Versionshinweis im Entwickler-Änderungsprotokoll an.
Funktionen bleiben aktiv 12 Monate nach einer Einstellungsmitteilung. Wir senden jedem Team per E-Mail ein aktives Zugriffstoken an 90, 30 und 7 Tage vor dem Cutoff – keine Überraschungen in der Produktion.
Bereit, mit dem Bau zu beginnen?
Fragen, beantwortet.
Es handelt sich um eine REST-Schnittstelle plus signierte Webhooks, die Sprachanrufe, SMS/MMS, Telefonnummern, Benutzer und KI-Oberflächen offenlegt. Authentifizieren Sie sich mit einem Bearer-Zugriffstoken, erreichen Sie die dokumentierten Endpunkte und versenden Sie innerhalb von Minuten.
Bauen Sie auf der API auf, Versand noch am selben Tag.
24/7-Support inklusive. Rufnummern, die von jedem Mobilfunkanbieter weltweit portiert werden.