同时选择 API 和凭据
已获批准的开发者与自动化、企业和通信服务提供商账户可以集成已启用的服务。个人开发者无需假装成公司。应用程序 SMS/MMS 需要相应的发送审批和注册。个人与家庭服务没有面向客户开放的消息发起 API。
| API 系列 | 基础 URL | 身份验证与结果 |
|---|---|---|
| 通信 v3 | https://api.multitel.net/v3 | 已获批准的 Basic 凭据；符合条件的已配置令牌仅适用于支持令牌的操作。JSON 包含 status 和 response。 |
| 紧急呼叫注册 | https://api.multi.tel/emergency | 已获批准的 Basic 凭据，或专门配置的 Bearer 访问权限。JSON 包含 code、message 和 data。 |
| 门户 REST 集成 | 以您账户的开发者参考中显示的主机和操作为准 | 请使用该操作文档中说明的凭据、权限范围和数据结构。浏览器会话请求属于另一类接口。 |
在使用示例之前，请通过服务器的密钥配置设置 MULTITEL_API_USERNAME 和 MULTITEL_API_PASSWORD。切勿将它们嵌入公开的浏览器 JavaScript、URL 或源代码管理中。专用凭据可在API 集成设置中管理。
无需注册号码即可读取覆盖范围
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multi.tel/emergency/coverage?environment=production"同样支持 https://api.multitel.net/emergency。两个紧急呼叫基础 URL 都不包含 /v3。覆盖范围会列出国际服务覆盖的国家、支持的号码类型和价格；北美 E911 的资格将在注册时检查。
{
"code": 200,
"message": "",
"environment": "production",
"requestId": "EXAMPLE_REQUEST_ID",
"data": {}
}这仅用于说明响应的结构。请在已发布的紧急呼叫 API 指南中查看每个操作的 data 数据结构。
注册、跟踪状态，然后配置呼叫
- 对于美国/加拿大以及其他受支持的北美 E911 地区，请提供号码、E911 地址以及所需的同意确认。北美 E911 仅限生产环境。
- 对于受支持且为您所拥有的国际号码，请提供已保存的 Document 引用，或提供最终用户的身份和地址。请先查看该国家和号码类型的要求。
- 发送一次
POST /registrations请求。可选的Idempotency-Key用于标识一次逻辑上的变更；重试时请保留该密钥和完全相同的负载。 - 读取
GET /registrations/:number。检查生命周期、pending和actionRequired；并处理所需的更正。被接受或处于待处理状态并不等于服务已生效。 - 激活之后，请配置正确的紧急主叫号码显示和针对具体国家的拨号路由。请使用该服务提供的非紧急验证流程。
国际沙盒注册在隔离环境中进行，不会激活真实的紧急呼叫。北美 E911 需要主账户凭据；指南说明了国际子账户的有限支持。
处理错误与重试
- 身份验证或权限失败
- 请检查 API 凭据是否已启用、是否允许使用所需服务，以及源 IP 限制。门户的会话 Cookie 不是集成凭据。
- 余额不足或审批条件未满足
- 请先解决账户余额、发送审批或文件要求问题，然后再重复该操作。
- 无结果
- 请将库存为空或查不到主叫名称视为正常结果处理。不要假定一个语法有效的号码就具备所有服务。
- 网络超时或服务故障
- 读取操作请使用有上限的重试并采用退避策略。对于购买、发送或注册操作，请先检查操作状态；重试已被接受的请求可能造成重复的计费操作。
幂等性支持取决于各个 API 系列。紧急呼叫 API 支持重试密钥，但这并不意味着任意 v3 请求都是幂等的。请保留时间戳、返回的 ID 以及已脱敏的响应，以便提供给支持团队。
继续查看您账户的参考文档
登录后的参考文档会根据您的权限和已启用的服务筛选操作。请使用其中给出的确切主机、凭据类型、请求字段和响应结构。控制台可以执行实际操作，包括购买和发送消息。