短信通知API接口对接指南

一、接入前准备工作

1. 注册互亿无线账号：通过官方平台完成账号注册，确保填写信息真实有效；

2. 完成实名认证：根据平台提示提交个人或企业身份资料，完成实名认证（企业用户需优先完成企业认证，见下文“二、企业认证”）；

3. 开通短信服务：在账号控制台找到“短信服务”模块，申请开通服务；

4. 获取API凭证：服务开通后，在“API设置”页面获取接口调用所需的APIID和APIKEY，妥善保存以便后续开发使用。

二、企业认证

1. 认证要求：根据工信部及运营商规定，国内短信需提供签名归属方的资质证件（如营业执照、组织机构代码证等）；

2. 认证流程：登录控制台→进入“企业认证”页面→按提示上传资质文件→提交审核；

3. 关键说明：企业认证审核通过后，才可申请短信签名（个人用户无需此步骤，但部分短信类型可能受限）；

4. 操作入口：点击 立即认证 按钮可直接进入认证页面，审核结果将通过短信或邮件通知。

三、申请短信签名

1. 签名定义：短信签名是短信发送方的标识，需能明确辨别主体（如企业名称、品牌名、授权主体名称等）；

2. 申请要求：

• 优先使用企事业单位全称或规范简称，确保与资质证件一致；
• 若使用授权主体名称，需额外提交授权证明文件；

3. 审核时效：提交申请后，预计2个小时内完成审核，审核通过后才可申请短信模板；

4. 操作入口：点击 申请短信签名 按钮进入申请页面，按提示填写信息并提交。

四、申请短信模板

1. 模板定义：短信模板是具体的短信发送内容，支持验证码、通知短信（如订单通知、物流提醒）等类型；

2. 模板结构：由“固定内容+变量”组成，变量用于实现内容个性化定制（如验证码、用户姓名、订单号等）；

3. 申请要求：

• 固定内容需符合短信发送规范，避免违规内容（如敏感词、营销违规表述）；
• 变量需规范命名（如【验证码】【订单号】），不可包含违规信息；

4. 示例模板：您的验证码是：【变量】。请不要将验证码泄露给其他人（此为常见验证码模板，可参考申请）；

5. 审核时效：提交申请后，预计2个小时内完成审核，审核通过后才可用于发送短信；

6. 操作入口：点击 申请短信模板 按钮进入申请页面，选择模板类型、填写内容并提交。

五、发送短信

1. 发送前提：需使用已审核通过且完成运营商报备的短信签名，搭配已审核通过的短信模板；

2. 内容组合：将模板中的变量替换为实际内容（如将【变量】替换为6位数字验证码），生成最终发送短信；

3. 测试建议：初期建议使用三大运营商（移动、联通、电信）的手机号，少量多次测试发送效果，确保短信送达率和稳定性；

4. 发送方式：

• 在线发送：通过控制台“短信发送”页面，手动输入接收手机号、选择签名和模板、填写变量内容，直接发送；
• API接口发送：通过开发对接API接口，集成到业务系统中，实现自动化发送（需使用前文获取的APIID和APIKEY）；

5. 操作入口：点击 在线发送 或 API接口发送 按钮，进入对应发送页面（API发送需参考接口文档完成开发）。

六、查询发送详情

1. 查询入口：登录互亿无线平台控制台，进入“短信记录”或“发送详情”模块；

2. 可查信息：实时查看短信发送状态（成功/失败/待发送）、发送时间、接收手机号、发送数量、失败原因（若失败）等；

3. 功能作用：便于监控业务发送效果，及时排查发送失败问题（如手机号错误、签名未报备等），优化短信发送策略；

4. 操作方式：支持按时间范围、发送批次、手机号等条件筛选查询，也可导出发送记录用于数据统计。