Skip to main content
Acepeak
Entwickler

Erstellen Sie Anrufe, Messaging und AI auf der Acepeak api.

REST-Endpunkte, Echtzeit-Webhooks und First-Class-SDKs. Authentifizieren Sie die api mit einem Bearer-Access-Token und senden Sie Ihre erste Anfrage in unter fünf Minuten.

place-call.sh
# 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"}'
Fünf Minuten bis zu Ihrem ersten Anruf

Schnellstart.

  1. 01Schritt

    Ein Access-Token erhalten

    Melden Sie sich beim Acepeak-Dashboard an, öffnen Sie Developers → Tokens und erstellen Sie ein neues Bearer-Token. Tokens sind pro Umgebung (Sandbox oder Live) auf einen Geltungsbereich beschränkt und jederzeit vom Dashboard aus rotierbar.

    Achtung — bewahren Sie Live-Tokens serverseitig auf. Alles, was einen Browser berührt, sollte über Ihr Backend laufen.

  2. 02Schritt

    Authentifizieren

    Jede Anfrage verwendet Bearer-Token-Authentifizierung im Authorization-Header.

    Authorization: Bearer YOUR_ACEPEAK_TOKEN
  3. 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 Entwickeln beginnen.

    curl https://endpoints.acepeak.com/v1/numbers \
      -H "Authorization: Bearer $ACEPEAK_TOKEN"
Was Sie erstellen können

Jede Funktion der Plattform wird über REST bereitgestellt.

Sprachanrufe

Ausgehende Anrufe tätigen, eingehende Anrufe steuern, weiterleiten, Konferenzen führen, aufzeichnen, transkribieren. Programmierbare Answer-URL-Abläufe, DTMF-Erfassung im Anruf, Echtzeit-Streaming.

/v1/calls/v1/conferences/v1/recordings

Messaging (SMS & MMS)

Senden und empfangen über US-10DLC-, gebührenfreie und Short-Code-Nummern. Bidirektional, Zustellbestätigungen, Opt-out-Compliance, verkettete lange Nachrichten.

/v1/messages/v1/messages/inbound

Telefonnummern

Suchen, kaufen, portieren und freigeben. Lokale US-, gebührenfreie und internationale DIDs in 60+ Ländern.

/v1/numbers/v1/numbers/available/v1/numbers/port-orders

Benutzer & Teams

Benutzer bereitstellen, Rollen zuweisen, Teams verwalten, SSO konfigurieren. SCIM 2.0 für automatisiertes Lifecycle-Management mit Ihrem IdP.

/v1/users/v1/teams/v1/sso

Webhooks

Echtzeit-Zustellung von Anruf-, Nachrichten- und Aufzeichnungsereignissen an Ihren Endpunkt. HMAC-SHA256-signiert, mit exponentiellem Backoff für 24 Std erneut versucht.

/v1/webhooks/v1/webhooks/{id}/events

AI-Oberflächen

Lösen Sie den AI Receptionist aus, rufen Sie Transkripte ab, holen Sie Sentiment-Bewertungen pro Anruf oder pro Chat.

/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment
Authentifizierung

Möglichkeiten zur Authentifizierung.

Access-Token-Authentifizierung

Empfohlen für Backend-Dienste. Bearer-Token wird bei jeder Anfrage gesendet. Tokens sind pro Umgebung auf einen Geltungsbereich beschränkt, vom Dashboard aus rotierbar und an eine bestimmte Rolle für minimale Rechtevergabe gebunden.

Authorization: Bearer YOUR_ACEPEAK_TOKEN

OAuth 2.0

Für Partner-Apps und Marketplace-Integrationen. Authorization-Code-Grant mit PKCE. Verwenden Sie dies, wenn Ihre App im Namen eines Kunden statt Ihres eigenen Kontos handelt.

  • Authorization Code + PKCE
  • Refresh-Tokens · 30 Tage Standard
  • Geltungsbereich pro Kunde
Rate Limits & Fehler

Vorhersehbar, dokumentiert und nie stillschweigend.

Rate Limits

Standard: 100 r/s pro Access-Token. Spitzen bis zu 200 r/s für kurze Zeitfenster. Bei Überschreitung gibt die Plattform 429 mit einem Retry-After-Header zurück.

Idempotenz

Verändernde Anfragen unterstützen einen Idempotency-Key Header. Verwenden Sie ihn bei POST-, PUT- und DELETE-Anfragen, damit Wiederholungen nicht doppelt belasten oder doppelt senden.

Fehlercodes

  • 400Ungültige AnfrageValidierung fehlgeschlagen
  • 401Nicht autorisiertUngültiges oder fehlendes Access-Token
  • 403VerbotenToken hat keinen Geltungsbereich
  • 404Nicht gefundenRessource nicht gefunden
  • 409KonfliktIdempotenz- oder Zustandskonflikt
  • 429RatenbegrenztLangsamer — Retry-After bereitgestellt
  • 5xxServerseitigMit exponentiellem Backoff erneut versuchen
Webhooks

Echtzeit-Events an Ihren Endpunkt geliefert.

Abonnieren Sie einen HTTPS-Endpunkt für Anruf-, Nachrichten- und Aufzeichnungs-Events. Webhooks werden mit HMAC-SHA256 signiert — verifizieren Sie die Signatur vor der Verarbeitung. Fehlgeschlagene Zustellungen werden mit exponentiellem Backoff bis zu 24 Stunden lang wiederholt. Sie können jedes Event vom Dashboard aus erneut abspielen.

POST · /your-webhookSigned
{
  "id": "evt_01HW3...",
  "type": "call.completed",
  "created_at": "2026-04-30T10:42:00Z",
  "data": {
    "call_id": "CA_01HW...",
    "duration_sec": 184
  }
}
HMAC-SHA256-signiert · Replay-sicher
24 Std exponentielle Backoff-Wiederholungen
Jedes Event vom Dashboard aus erneut abspielen
Nach Event-Typ filtern · pro Endpunkt
SDKs

First-Class-Bibliotheken, spiegelgleich zu REST abgebildet.

Node.jsnpm install @acepeak/sdkInstallieren
Pythonpip install acepeakInstallieren
PHPcomposer require acepeak/sdkInstallieren
Gogo get github.com/acepeak/acepeak-goInstallieren
Rubygem install acepeakInstallieren
MIT-lizenziert · gleicher Release-Rhythmus wie die PlattformPostman →
Versionierung

Stabile URLs. Vorhersehbare Upgrades.

Schnittstellenversionen sind in der URL fixiert (/v1/). Breaking Changes erscheinen hinter einer neuen Hauptversion. Nicht brechende Ergänzungen kommen in derselben Version mit einem Release-Hinweis im Developer-Changelog.

Deprecation-Richtlinie

Funktionen bleiben aktiv für 12 Monate nach einer Deprecation-Ankündigung. Wir benachrichtigen jedes Team mit einem aktiven Access-Token per E-Mail 90, 30 und 7 Tage vor dem Stichtag — keine Überraschungen in der Produktion.

Bereit, mit dem Entwickeln zu beginnen?

FAQ

Fragen, beantwortet.

Es ist eine REST-Schnittstelle plus signierte Webhooks, die Sprachanrufe, SMS / MMS, Telefonnummern, Benutzer und AI-Oberflächen bereitstellt. Authentifizieren Sie sich mit einem Bearer-Access-Token, rufen Sie die dokumentierten Endpunkte auf und gehen Sie in Minuten live.

REST · Webhooks · SDKs

Bauen Sie auf der api, und veröffentlichen Sie am selben Tag.

24/7 Support inklusive. Rufnummern von jedem Carrier weltweit portierbar.

24/7 Support60+ LänderSOC 2 IISandbox-Konsole
Zuletzt aktualisiert: Mai 2026