营销短信API接口对接操作指南

一、准备对接基础资料

1. 下载接口相关文件:点击下载API接口文档及短信对接常见问题手册,提前了解接口参数、调用规则及问题解决方案。

2. 获取APIID与APIKEY(核心凭证):

  • 步骤1:登录客户端平台;
  • 步骤2:点击左侧「营销短信」菜单;
  • 步骤3:在页面右上角即可查看APIID及APIKEY信息(参考右侧示意图)。

注意事项:

  • APIID、APIKEY与平台登录的用户名、密码不通用,需单独保存;
  • 查看APIKEY时,需完成账户负责人的手机验证,验证通过后方可显示。

二、营销短信在线发送操作

若需快速测试或少量发送营销短信,可通过平台在线功能操作,步骤如下:

  • 步骤1:登录客户端平台;
  • 步骤2:点击左侧「营销短信」菜单;
  • 步骤3:进入「营销在线发送」页面,选择「在线发送」功能;
  • 步骤4:按页面提示完成配置:选择已审核通过的短信签名、填写合规的营销短信内容、上传目标发送号码(支持TXT/Excel格式)、按需设定定时发送时间;
  • 步骤5:确认信息无误后,提交发送任务即可。

三、模板与签名使用规范

1. 若使用平台默认模板和签名:可直接用于程序调试,无需额外申请;

2. 若使用自定义模板和签名:需先完成企业认证,认证通过后申请专属模板与签名,审核通过方可用于营销短信对接调试。

四、接口返回状况查看与处理

  • 1. 状态获取方式:通过调用「提交状态接口」,获取短信提交的实时状态信息,辅助分析对接中遇到的提交问题;
  • 2. 重试规则:若提交失败,重试次数请勿超过1次,避免重复提交导致资源浪费或数据混乱;
  • 3. 报错排查:若遇接口报错,可点击查看接口报错代码说明,根据代码释义快速定位并解决问题。

五、账户安全设置建议

为保障账户及短信发送安全,建议配置以下安全参数:

  • 1. 绑定服务器IP:在平台安全设置中添加您方服务器IP,系统仅接收已绑定IP提交的短信请求,有效防范非法请求;
  • 2. 技术对接支持:建议将您方工程师加入对接讨论组,可直接与我方免费技术支持工程师沟通,提升对接效率与顺畅度。