构建通话、消息传递和 AI 在 Acepeak API 上。
REST 端点、实时 Webhook 和一流的 SDK。使用不记名访问令牌对 api 进行身份验证，并在五分钟内发送您的第一个请求。
# 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"}'快速入门。
- 01步
获取访问令牌
登录 Acepeak 仪表板，打开开发人员 → 令牌，然后创建一个新的不记名令牌。令牌的范围按环境（沙箱或实时）划分，并且可以随时从仪表板轮换。
注意——将实时令牌保留在服务器端。任何涉及浏览器的内容都应该通过您的后端。
- 02步
认证
每个请求都在授权标头中使用不记名令牌身份验证。
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03步
发送您的第一个请求
拨打电话、发送短信或列出您的号码 - 选择适合您的用例的选项。您应该会看到电话号码的 JSON 列表。从那里，您可以拨打电话、发送短信、设置 Webhooks 并开始构建。
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
平台中的每项能力 通过 REST 暴露。
语音通话
拨出电话、控制呼入电话、转接、会议、录音、转录。可编程应答 URL 流、通话中 DTMF 捕获、实时流。
/v1/calls/v1/conferences/v1/recordings消息传送（短信和彩信）
通过 US 10DLC、免费电话和短代码号码发送和接收。双向、送达收据、选择退出合规性、串联长消息。
/v1/messages/v1/messages/inbound电话号码
搜索、购买、移植和发布。遍布 60 多个国家/地区的美国本地、免费电话和国际 DID。
/v1/numbers/v1/numbers/available/v1/numbers/port-orders用户和团队
配置用户、分配角色、管理团队、配置 SSO。 SCIM 2.0 用于 IdP 的自动化生命周期管理。
/v1/users/v1/teams/v1/sso网络钩子
将呼叫、消息和录音事件实时传送到您的端点。 HMAC-SHA256 签名，以指数退避重试 24 小时。
/v1/webhooks/v1/webhooks/{id}/events人工智能表面
触发人工智能接待员，提取文字记录，获取每次通话或每次聊天的情绪分数。
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment方式 进行身份验证。
访问令牌身份验证
推荐用于后端服务。每个请求中发送的不记名令牌。令牌按环境划分范围，可从仪表板轮换，并与特定角色绑定以实现最低权限访问。
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
用于合作伙伴应用程序和市场集成。通过 PKCE 授予授权码。当您的应用程序代表客户而不是您自己的帐户运行时，请使用此选项。
- 授权码+PKCE
- 刷新令牌 · 默认 30 天
- 每个客户的范围界定
可预测、有记录、 并且从不沉默。
速率限制
默认： 100转/秒 每个访问令牌。爆发高达 200转/秒 对于短窗口。超过时，平台会返回 429 以及 Retry-After 标头。
幂等性
变异请求支持 Idempotency-Key 标头。在 POST、PUT 和 DELETE 请求上使用它，这样重试就不会重复收费或重复发送。
错误代码
400错误的请求验证失败401未经授权访问令牌无效或丢失403禁止令牌没有范围404未找到找不到资源409冲突幂等性或状态不匹配429速率有限放慢速度 — 提供后重试5xx服务器端使用指数退避重试
实时事件 传送到您的端点。
订阅 HTTPS 端点以进行呼叫、消息和录音事件。 Webhook 使用 HMAC-SHA256 进行签名 - 在处理之前验证签名。失败的交付将在长达 24 小时内以指数退避重试。您可以从仪表板重播任何事件。
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}稳定的网址。 可预测的升级。
接口版本固定在 URL 中 (/v1/). 新的主要版本背后有重大变化。同一版本中添加了不间断的补充内容，并在开发人员变更日志中发布了发行说明。
功能保持活力 12个月 在发出弃用通知后。我们通过电子邮件向每个团队发送有效的访问令牌： 90、30 和 7 天 在停产之前——生产中没有什么意外。
问题， 回答道。
它是一个 REST 接口加上签名的 Webhook，可公开语音通话、短信/彩信、电话号码、用户和 AI 界面。使用不记名访问令牌进行身份验证，到达记录的端点，并在几分钟内发货。
基于 API 构建， 当天发货。
包括 24/7 支持。从全球任何运营商转入的号码。