同时选择 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 集成设置中管理。
准备 SMS 请求
请使用账户拥有的、已获批准且启用了 SMS 的发送号码，向已同意接收该消息的收件人发送，并完成所需的品牌/活动（Brand/Campaign）注册或被叫付费号码验证。使用有效的凭据和号码填写后，下面的示例会发送真实的消息；它不是沙盒环境。
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"请将发送方和收件人占位符替换为包含国家代码的国际格式电话号码，并且只使用数字。对于 MMS，请在 media 中提供受支持且可公开获取的媒体 URL，并先确认 MMS 的资格和价格。
处理错误与重试
- 身份验证或权限失败
- 请检查 API 凭据是否已启用、是否允许使用所需服务，以及源 IP 限制。门户的会话 Cookie 不是集成凭据。
- 余额不足或审批条件未满足
- 请先解决账户余额、发送审批或文件要求问题，然后再重复该操作。
- 无结果
- 请将库存为空或查不到主叫名称视为正常结果处理。不要假定一个语法有效的号码就具备所有服务。
- 网络超时或服务故障
- 读取操作请使用有上限的重试并采用退避策略。对于购买、发送或注册操作，请先检查操作状态；重试已被接受的请求可能造成重复的计费操作。
幂等性支持取决于各个 API 系列。紧急呼叫 API 支持重试密钥，但这并不意味着任意 v3 请求都是幂等的。请保留时间戳、返回的 ID 以及已脱敏的响应，以便提供给支持团队。
继续查看您账户的参考文档
登录后的参考文档会根据您的权限和已启用的服务筛选操作。请使用其中给出的确切主机、凭据类型、请求字段和响应结构。控制台可以执行实际操作，包括购买和发送消息。