Développez les appels, la messagerie et l'IA sur l'API Acepeak.
Points de terminaison REST, webhooks en temps réel et SDK de première classe. Authentifiez l'API avec un jeton d'accès au porteur et envoyez votre première demande 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
Obtenez un jeton d'accès
Connectez-vous au tableau de bord Acepeak, ouvrez Développeurs → Jetons et créez un nouveau jeton de porteur. Les jetons sont définis par environnement (bac à sable ou en direct) et peuvent être pivotés à tout moment depuis le tableau de bord.
Attention : conservez les jetons en direct côté serveur. Tout ce qui touche un navigateur doit passer par votre backend.
- 02étape
Authentifier
Chaque demande utilise l'authentification par jeton du porteur dans l'en-tête Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03étape
Envoyez votre première demande
Passez un appel, envoyez un SMS ou répertoriez vos numéros : choisissez celui qui correspond à votre cas d'utilisation. 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 à créer.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Toutes les fonctionnalités de la plateforme est exposé via REST.
Appels vocaux
Passez des appels sortants, contrôlez les appels entrants, transférez, organisez une conférence, enregistrez, transcrivez. Flux d'URL de réponse programmables, capture DTMF en appel, streaming en temps réel.
/v1/calls/v1/conferences/v1/recordingsMessagerie (SMS et MMS)
Envoyez et recevez sur des numéros américains 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. DID locaux aux États-Unis, sans frais et internationaux dans plus de 60 pays.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtilisateurs et équipes
Provisionnez les utilisateurs, attribuez des rôles, gérez les équipes, configurez le SSO. SCIM 2.0 pour une gestion automatisée du cycle de vie avec votre IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Transmission en temps réel des événements d'appel, de message et d'enregistrement à votre point de terminaison. HMAC-SHA256 signé, réessayé avec une interruption exponentielle pendant 24 h.
/v1/webhooks/v1/webhooks/{id}/eventsSurfaces IA
Déclenchez le réceptionniste IA, extrayez des transcriptions, récupérez les scores de sentiment par appel ou par chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentFaçons pour authentifier.
Authentification du jeton d'accès
Recommandé pour les services backend. Jeton du porteur envoyé à chaque demande. Les jetons sont définis par environnement, rotatifs à partir du tableau de bord et liés à un rôle spécifique pour un accès avec le moindre privilège.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Pour les applications partenaires et les intégrations de Marketplace. Octroi de code d’autorisation avec PKCE. Utilisez-le lorsque votre application agit au nom d'un client plutôt que de votre propre compte.
- Code d'autorisation + PKCE
- Actualiser les jetons · 30 jours par défaut
- Cadrage par client
Prévisible, documenté, et jamais silencieux.
Limites de taux
Défaut: 100 tr/min par jeton d'accès. Éclate jusqu'à 200 tr/min pour les fenêtres courtes. En cas de dépassement, la plateforme renvoie 429 avec un en-tête Retry-After.
Idempotence
Les requêtes de mutation prennent en charge un Idempotency-Key en-tête. Utilisez-le sur les requêtes POST, PUT et DELETE afin que les nouvelles tentatives ne soient pas facturées ou envoyées deux fois.
Codes d'erreur
400Mauvaise demandeÉchec de la validation401Non autoriséJeton d'accès invalide ou manquant403InterditLe jeton n'a pas de portée404Pas trouvéRessource introuvable409ConflitIdempotence ou inadéquation des États429Tarif limitéRalentir – Réessayer-après fourni5xxCôté serveurRéessayez avec une interruption exponentielle
Événements en temps réel livré à votre point final.
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 le traitement. Les livraisons ayant échoué sont réessayées avec un délai exponentiel pouvant aller 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
}
}Bibliothèques de premier ordre, mappé en miroir sur REST.
URL stables. Mises à niveau prévisibles.
Les versions de l'interface sont épinglées dans l'URL (/v1/). Les modifications majeures sont livrées derrière une nouvelle version majeure. Des ajouts ininterrompus arrivent sur la même version avec une note de version dans le journal des modifications du 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 avec un jeton d'accès actif à 90, 30 et 7 jours avant la date limite – pas de surprises dans la production.
Prêt à commencer à construire ?
Questions, répondit.
Il s'agit d'une interface REST et de webhooks signés qui exposent les appels vocaux, les SMS/MMS, les numéros de téléphone, les utilisateurs et les surfaces d'IA. Authentifiez-vous avec un jeton d'accès au porteur, accédez aux points de terminaison documentés et expédiez en quelques minutes.
Construisez sur l'API, expédier le jour même.
Assistance 24h/24 et 7j/7 incluse. Numéros portés depuis n’importe quel opérateur dans le monde.