本页目录：
1、CMPP提交
【xxxx】123#变量1#变量2
| 示例 | 说明 |
|---|---|
| 【xxxx】 | 填写您要发送的彩信的签名 |
| 123 | 填写您报备通过的彩信内容id |
| #变量1#变量2 | 如果彩信内容是变量彩信，则根据内容中报备的变量数在彩信内容后追加实际变量，每个新变量以#开头，如果是普通彩信，则无需填写，直接以【xxxx】123格式提交 |
如果管理员未给您特殊的对接格式则按照方案一对接，否则以管理员给的格式进行对接
2、视频短信签名报备
请求头Content-Type：application/x-www-form-urlencoded
请求方式：POST 返回值：JSON
地址：https://api.3yit.com/mms/sign
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| account | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（32位，开发者，http接口文档中查看) | 是 |
| sign | 签名 | 测试签名 | 是 |
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 失败有返回，详情见错误表 | WL:NMLJ |
3、获取签名审核状态
请求头Content-Type：application/x-www-form-urlencoded
请求方式：GET 返回值：JSON
地址：https://api.3yit.com/mms/sign-status
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| account | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（32位，开发者，http接口文档中查看) | 是 |
| sign_id | 签名id | 22 | 是 |
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 审核状态0-待审核 1-审核通过 2-被驳回 | {"status":"1"} |
4、视频短信模板内容报备
请求头Content-Type：application/x-www-form-urlencoded
请求方式：POST 返回值：JSON
地址：https://api.3yit.com/mms/template
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| account | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（开发者，http接口文档中查看) | 是 |
| title | 彩信标题 | 测试 | 是 |
| content | 模版内容 | 详见格式说明 | 是 |
| sign_id | 报备的签名id | 22 | 是 |
| is_personality | 是否是变量模版0-否 1-是 | 1 | 是 |
模版content格式说明
1、多个帧之间以英文;分隔
2、每一帧以"3,"开头,之后的数据用英文,分隔
3、数据用英文|分隔，|前是上传的文件类型，|后是文件的base64编码数据
4、如果是变量文本，则占位符是${Text},比如：尊敬的${Text}您好
5、支持格式txt, gif, jpg, mp3, mp4, 3gp
6、例：3,txt|5rWL6K+V5LiA5LiL;3,txt|5rWL6K+V5LiA5LiL,mp4|3i/Zy9/g1ttOfqUy0JRTw8YuI3CyKPV
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 模版id | {"temp_id":49} |
5、获取模版审核状态
请求头Content-Type：application/x-www-form-urlencoded
请求方式：GET 返回值：JSON
地址：https://api.3yit.com/mms/template-status
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| account | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（开发者，http接口文档中查看) | 是 |
| temp_id | 模版id | 22 | 是 |
返回值
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 审核状态0-待审核 1-审核通过 2-被驳回 | {"status":"1"} |
6、普通视频短信发送
请求头Content-Type：application/x-www-form-urlencoded
请求方式：POST 返回值：JSON
地址：https://api.3yit.com/mms/send-temp
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（开发者-http接口文档中查看) | 否 |
| temp_id | 模版id | 12 | 是 |
| mobiles | 手机号（多个手机号以英文,分割） | 17611111111,17611111112 | 是 |
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 任务ID | {"task_id": 112} |
7、变量视频短信发送
请求头Content-Type：application/x-www-form-urlencoded
请求方式：POST 返回值：JSON
地址：https://api.3yit.com/mms/send-personal
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（开发者-http接口文档中查看) | 否 |
| temp_id | 模版id | 12 | 是 |
| mobiles | 手机号（多个手机号以英文,分割） | 17611111111,17611111112 | 是 |
| personality | 变量json（如果是变量模版需要带上这个参数） | {"17611111111":["参数1","参数2"],"17611111112":["参数1","参数2"]} | 否 |
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 任务ID | {"task_id": 112} |
8、获取状态报告
请求头Content-Type：application/x-www-form-urlencoded
请求方式：GET 返回值：JSON
地址：https://api.3yit.com/mms/report
参数
| 参数名 | 参数介绍 | 示例 | 必填 |
|---|---|---|---|
| sp_id | 产品sp_id | 5xxxxx（开发者-http接口文档中查看) | 是 |
| password | 密码 | xxxxxxxxxxx（开发者-http接口文档中查看) | 否 |
结果
| 参数名 | 参数说明 | 示例 |
|---|---|---|
| code | 详情见错误表 | 0 |
| msg | 成功-success 错误-其他提示 | success |
| data | 任务ID | [{"mobile":"18000000000","task_id":"103","status":"WL:CXQS"},{"mobile":"19100000000","task_id":"103","status":"WL:CXQS"}] |
9、错误码
| code错误码 | 说明 |
|---|---|
| 10001 | 参数错误，请确认 |
| 10011 | 余额不足，请尽快充值 |
| 10102 | 密码错误，请确认 |
| 10201 | 手机号必须填写 |
| 10401 | 用户名或密码不能为空 |
| 10402 | 个性参数不能为空 |
| 10403 | 彩信模版不能为空 |
| 10404 | 彩信内容不能为空 |
| 10406 | 该产品不支持彩信发送 |
| 10407 | 标题不能为空 |
| 10408 | 状态报告未配置拉取，无法获取 |
| 10409 | 彩信模版不存在或还未审核通过 |
| 10410 | 接口使用错误，请确认接口地址 |
| 10411 | 彩信签名不能为空 |
| 10412 | 该产品下您已提交过该签名，请勿重复提交 |
| 10413 | 签名不能为空 |
| 10414 | 上传的文件过大，总体积请勿超过2M |
| 10415 | 不支持该文件格式 |
| 10416 | 该签名不存在，请先报备签名 |
| 10417 | 个性彩信必须包含变量 |