同时选择 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 集成设置中管理。
查询号码
GET /v3/lrn/{number} 在路径中接受目的号码。对于取决于主叫号码的信息，可以选择通过 /v3/lrn/{number}/{ani} 提供主叫号码。请用纯数字输入北美电话号码，并在适用时包含国家代码；示例使用的是保留的虚构号码。
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"使用有效凭据执行查询会产生费用。费率为每次查询 US$0.00025：每 1,000 次 US$0.25，或每百万次 US$250。没有批量折扣。这是路由信息查询，不会拨打电话。
解读结果
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}这个虚构的示例仅用于演示响应的结构，并非实测的路由结果。使用 response 之前请先检查 status.code。cost 字段是带有货币前缀的字符串，而不是 JSON 数字。
| 字段 | 含义 |
|---|---|
lrn | 位置路由号码（Location Routing Number），用于标识路由目的地。 |
ported | 此查询提供的携号转网指示：通常为 0 或 1。请勿将其作为所有权或服务资格的证明。 |
ocn | 运营公司编号（Operating Company Number），如有提供。 |
lata | 本地接入与传输区域（Local Access and Transport Area），如有提供。 |
rc | 费率中心（Rate center），如有提供。 |
city, state, lec, lectype, jurisdiction, local | 在可用时提供的其他位置、运营商或与来源相关的详细信息。它们可能缺失或为空。 |
不要要求每个路由字段都必须存在。特别是，被叫付费号码的结果可能省略本地费率中心和运营商代码的详细信息。返回的 LRN 并不能实时保证可达性，也不是通话质量测试。
在路由工作流中使用查询
- 在发送之前，先验证并规范化所请求的号码。
- 检查 HTTP 状态和应用层状态。请保留号码、时间和结果的脱敏记录，以便排查问题。
- 仅使用与您的路由规则相关的字段，并明确处理缺失的值。
- 在响应不确定后，请限制重试次数。重复查询可能产生另一次费用；此端点没有文档说明的幂等密钥。
查看 LRN 产品和统一定价。公开的 OpenAPI 路径包含 ANI 段；已部署的 LRN 实现也接受不含 ANI 的较短请求。lrninfo 是另一个独立的操作，不应用来替代此端点。
处理错误与重试
- 身份验证或权限失败
- 请检查 API 凭据是否已启用、是否允许使用所需服务，以及源 IP 限制。门户的会话 Cookie 不是集成凭据。
- 余额不足或审批条件未满足
- 请先解决账户余额、发送审批或文件要求问题，然后再重复该操作。
- 无结果
- 请将库存为空或查不到主叫名称视为正常结果处理。不要假定一个语法有效的号码就具备所有服务。
- 网络超时或服务故障
- 读取操作请使用有上限的重试并采用退避策略。对于购买、发送或注册操作，请先检查操作状态；重试已被接受的请求可能造成重复的计费操作。
幂等性支持取决于各个 API 系列。紧急呼叫 API 支持重试密钥，但这并不意味着任意 v3 请求都是幂等的。请保留时间戳、返回的 ID 以及已脱敏的响应，以便提供给支持团队。
继续查看您账户的参考文档
登录后的参考文档会根据您的权限和已启用的服务筛选操作。请使用其中给出的确切主机、凭据类型、请求字段和响应结构。控制台可以执行实际操作，包括购买和发送消息。