开发者 API
API 密钥、公共 REST API 和用于 AI 集成的 MCP 服务器。
获取您的 Ody API 密钥
在**设置 → 开发者 API**中创建、限定范围和撤销 Ody API 密钥。选择实时或测试模式 — 您的密钥仅显示一次,请立即复制。
API 概览与认证
使用 Bearer 密钥调用 api.ody.co 上的 Ody REST API:联系人、对话、消息、号码和 10DLC、AI 呼叫、您的代理以及 Webhook。
将 AI 工具与 MCP 连接
将 Ody 添加为 MCP 服务器,以便 ChatGPT、Claude 和 Cursor 可以处理您的收件箱、发送短信、购买号码、拨打 AI 电话以及管理您的 AI 代理。
通过API购买号码并注册短信功能
通过Ody API或MCP搜索和购买电话号码,并提交10DLC短信注册——与应用内操作具有相同的计费、门槛和账户。
通过 API 拨打 AI 电话并管理 Astra
让 Astra 通过 POST /calls 拨出电话,配置并发布您的 AI 助理,并将号码路由到它——通过 Ody REST API 或 MCP 工具。
API速率限制和最佳实践
每个Ody API密钥每分钟可获得600个请求。请阅读RateLimit标头,在遇到429错误时进行退避,并遵循这些密钥安全最佳实践。
接收 Webhook 并验证签名
通过 Ody API 注册 HTTPS Webhook 端点,订阅 `message.received` 等事件,并使用您的 `whsec_` 密钥验证签名交付。
使用测试模式安全构建
创建 ody_test_ API 密钥,以便在发送、号码购买、AI 呼叫和 10DLC 备案被模拟时,针对真实工作区数据进行构建。
分页、幂等性和错误处理
使用游标对 Ody API 列表进行分页,使用 Idempotency-Key 标头安全地重试发送,并处理统一的错误封装和请求 ID。
SDK快速入门:TypeScript和Python
开始使用Ody的TypeScript和Python SDK — 发送消息、购买号码、拨打AI电话、管理您的代理、分页和验证Webhooks。