Créez des appels, de la messagerie et de l’AI sur l’API Acepeak.
Endpoints REST, webhooks en temps réel et SDK de premier ordre. Authentifiez l’API avec un jeton d’accès bearer et envoyez votre première requête en moins de cinq minutes.
# 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"}'Démarrage rapide.
- 01étape
Obtenir un jeton d’accès
Connectez-vous au tableau de bord Acepeak, ouvrez Développeurs → Jetons et créez un nouveau jeton bearer. Les jetons sont délimités par environnement (sandbox ou live) et renouvelables depuis le tableau de bord à tout moment.
Attention — conservez les jetons live côté serveur. Tout ce qui passe par un navigateur doit transiter par votre backend.
- 02étape
S’authentifier
Chaque requête utilise l’authentification par jeton bearer dans l’en-tête Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03étape
Envoyez votre première requête
Passez un appel, envoyez un SMS ou listez vos numéros — choisissez ce qui correspond à votre cas d’usage. Vous devriez voir une liste JSON de vos numéros de téléphone. À partir de là, vous pouvez passer des appels, envoyer des SMS, configurer des webhooks et commencer à développer.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Chaque capacité de la plateforme est exposée via REST.
Appels vocaux
Passez des appels sortants, contrôlez les appels entrants, transférez, organisez des conférences, enregistrez, transcrivez. Flux d’answer-URL programmables, capture DTMF en cours d’appel, streaming en temps réel.
/v1/calls/v1/conferences/v1/recordingsMessagerie (SMS et MMS)
Envoyez et recevez sur des numéros US 10DLC, gratuits et à code court. Bidirectionnel, accusés de réception, conformité de désinscription, messages longs concaténés.
/v1/messages/v1/messages/inboundNuméros de téléphone
Recherchez, achetez, portez et libérez. DIDs locaux US, gratuits et internationaux dans plus de 60 pays.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtilisateurs et équipes
Provisionnez des utilisateurs, attribuez des rôles, gérez les équipes, configurez le SSO. SCIM 2.0 pour la gestion automatisée du cycle de vie avec votre IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Livraison en temps réel des événements d’appel, de message et d’enregistrement vers votre endpoint. Signés HMAC-SHA256, réessayés avec backoff exponentiel pendant 24h.
/v1/webhooks/v1/webhooks/{id}/eventsSurfaces AI
Déclenchez l’AI Receptionist, extrayez des transcriptions, récupérez des scores de sentiment par appel ou par chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentMéthodes pour s’authentifier.
Authentification par jeton d’accès
Recommandé pour les services backend. Jeton Bearer envoyé dans chaque requête. Les jetons sont délimités par environnement, renouvelables depuis le tableau de bord et liés à un rôle spécifique pour un accès au moindre privilège.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Pour les applications partenaires et les intégrations de marketplace. Octroi Authorization Code avec PKCE. Utilisez-le lorsque votre application agit pour le compte d’un client plutôt que de votre propre compte.
- Authorization Code + PKCE
- Jetons de rafraîchissement · 30 jours par défaut
- Délimitation par client
Prévisibles, documentées, et jamais silencieuses.
Limites de débit
Par défaut : 100 r/s par jeton d’accès. Pics jusqu’à 200 r/s sur de courtes fenêtres. En cas de dépassement, la plateforme renvoie un 429 avec un en-tête Retry-After.
Idempotence
Les requêtes mutatives prennent en charge un en-tête Idempotency-Key . Utilisez-le sur les requêtes POST, PUT et DELETE pour que les nouvelles tentatives ne facturent ni n’envoient en double.
Codes d’erreur
400Requête incorrecteÉchec de la validation401Non autoriséJeton d’accès invalide ou manquant403InterditLe jeton n’a pas la portée requise404IntrouvableRessource introuvable409ConflitIncohérence d’idempotence ou d’état429Limité en débitRalentissez — Retry-After fourni5xxCôté serveurRéessayez avec un backoff exponentiel
Événements en temps réel livrés à votre point de terminaison.
Abonnez un point de terminaison HTTPS aux événements d’appel, de message et d’enregistrement. Les webhooks sont signés avec HMAC-SHA256 — vérifiez la signature avant traitement. Les livraisons échouées sont retentées avec un backoff exponentiel pendant jusqu’à 24 heures. Vous pouvez rejouer n’importe quel événement depuis le tableau de bord.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Des bibliothèques de premier ordre, calquées sur REST.
Des URL stables. Des mises à niveau prévisibles.
Les versions d’interface sont figées dans l’URL (/v1/). Les changements cassants sont livrés derrière une nouvelle version majeure. Les ajouts non cassants arrivent sur la même version avec une note de version dans le changelog développeur.
Les fonctionnalités restent actives pendant 12 mois après un avis de dépréciation. Nous envoyons un e-mail à chaque équipe disposant d’un jeton d’accès actif à 90, 30 et 7 jours avant l’échéance — aucune surprise en production.
Prêt à commencer à développer ?
Des questions, des réponses.
C’est une interface REST plus des webhooks signés qui exposent les appels vocaux, les SMS / MMS, les numéros de téléphone, les utilisateurs et les surfaces AI. Authentifiez-vous avec un jeton d’accès bearer, appelez les endpoints documentés et livrez en quelques minutes.
Développez sur l’api, livrez le jour même.
Support 24/7 inclus. Numéros portés depuis n’importe quel opérateur dans le monde.