基于 Acepeak api 构建通话、消息和 AI。
REST 端点、实时 webhooks 和一流的 SDK。使用 bearer 访问令牌对 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 仪表板，打开 Developers → Tokens，并创建一个新的 bearer 令牌。令牌按环境（沙箱或正式）划分权限范围，可随时在仪表板中轮换。
请注意——正式令牌务必保留在服务端。任何涉及浏览器的内容都应经由您的后端处理。
- 02步骤
身份验证
每个请求都在 Authorization 标头中使用 bearer 令牌进行身份验证。
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03步骤
发送您的第一个请求
发起一通通话、发送一条 SMS，或列出您的号码——选择最适合您用例的方式。您应当会看到一个 JSON 格式的电话号码列表。从这里开始，您便可发起通话、发送 SMS、设置 webhooks 并着手构建。
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
平台中的每一项能力 均通过 REST 开放。
语音通话
发起外呼、控制呼入、转接、会议、录音、转写。可编程的应答 URL 流程、通话中 DTMF 捕获、实时流式传输。
/v1/calls/v1/conferences/v1/recordings消息（SMS 和 MMS）
通过美国 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/ssoWebhooks
将通话、消息和录音事件实时投递至您的端点。采用 HMAC-SHA256 签名，并以指数退避方式重试 24 小时。
/v1/webhooks/v1/webhooks/{id}/eventsAI 触点
触发 AI Receptionist、拉取通话记录、按通话或按聊天获取情绪评分。
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentiment方式 进行身份验证。
访问令牌身份验证
推荐用于后端服务。每个请求都发送 bearer 令牌。令牌按环境划分权限范围，可在仪表板中轮换，并与特定角色绑定以实现最小权限访问。
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
适用于合作伙伴应用和市场集成。采用带 PKCE 的授权码授予。当您的应用代表客户而非您自己的账户行事时，请使用此方式。
- 授权码 + PKCE
- 刷新令牌 · 默认 30 天
- 按客户划分权限范围
可预测、有文档记录， 且绝不静默。
速率限制
默认： 100 r/s 每个访问令牌。突发可达 200 r/s 适用于短时间窗口。超出后，平台将返回带 Retry-After 标头的 429。
幂等性
变更类请求支持一个 Idempotency-Key 标头。请在 POST、PUT 和 DELETE 请求上使用它，使重试不会重复计费或重复发送。
错误代码
400错误请求验证失败401未授权访问令牌无效或缺失403禁止访问令牌不具备相应权限范围404未找到未找到资源409冲突幂等性或状态不匹配429已限速请放慢速度——已提供 Retry-After5xx服务端以指数退避方式重试
实时事件 投递至您的端点。
为通话、消息和录音事件订阅一个 HTTPS 端点。Webhooks 采用 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。 可预测的升级。
接口版本固定在 URL 中 (/v1/). 破坏性变更随新的主版本发布。非破坏性新增功能在同一版本中提供，并在开发者更新日志中附有发布说明。
功能将保持可用 12 个月 在弃用通知发出之后。我们会在以下时间向每个持有有效访问令牌的团队发送邮件： 90、30 和 7 天 在截止日期之前——生产环境绝无意外。
有疑问， 为您解答。
它是一套 REST 接口加签名 webhooks，开放语音通话、SMS / MMS、电话号码、用户和 AI 触点。使用 bearer 访问令牌进行身份验证、调用文档化的端点，几分钟内即可上线。
基于 api 构建， 当天即可上线。
含 24/7 支持。可从全球任意运营商携入号码。