视频短信/彩信接口如何对接?
视频短信/彩信接口对接需遵循标准化流程及技术规范,涵盖注册认证、参数配置、调试上线等环节,确保接口功能正常集成。
接入流程分为以下步骤:
- 注册登录:在线自助注册并登录用户中心;
- 实名认证:在线提交企业认证材料完成审核;
- 签名/模板申请:签订合作协议后提交彩信签名及模板审核;
- 免费调试:启用接口后系统自动赠送测试条数,支持下载API接口进行调试;
- 正式发送:审核通过后使用接口正式发送视频短信/彩信。
接口请求需包含以下核心参数:
| 参数名称 | 参数值描述 | 示例 | 类型 | 必填 |
| api_id | APIID(用户中心【富媒体短信】-【5G视频短信】-【产品总览】查看) | mms-xxxxxxxx | string | 是 |
| signature | 请求验证加密签名;生成方式为公共参数按ASCII码排序后md5 32位小写加密 | xxxxxxxxx | string | 是 |
| timestamp | 东八时区10位时间戳,允许相差±60S | 1623643787 | int | 是 |
| request_id | 请求方唯一ID(如uuid),系统2小时内去重验证 | xxxxxxxxxxxx | string | 是 |
| product_id | 产品ID | 1001 | int | 是 |
| phone | 手机号数组(最多1万个号码) | [\"136xxxxxxxx\",\"139xxxxxxxx\"] | array | 是 |
| sign_name | 彩信签名(template_id未填写则必填) | xxxxxxxx | string | 是 |
| title | 彩信标题(template_id未填写则必填) | xxxxxxxxxxxx | string | 是 |
| content | 彩信内容(与template_id二选一),需按DataItem结构传入 | [{\\\"con_type\\\":\\\"txt\\\",\\\"data\\\":\\\"base64编码内容\\\,{\\\"con_type\\\":\\\"img\\\",\\\"ext_type\\\":\\\"jpg\\\",\\\"data\\\":\\\"base64编码图片\\\] | array | 是 |
| template_id | 模板ID(content为空则必填) | 1 | int | 否 |
对接时需注意以下细节:
- timestamp参数需与服务器时间差不超过±60秒;
- request_id需使用唯一标识符避免重复请求;
- content与template_id参数需二选一传入,同时传入时content生效;
- signature签名需严格按ASCII排序规则加密,确保请求合法性;
- phone参数需按数组格式传入,单次最多支持1万个号码。
互亿无线提供视频短信/彩信接口对接的全程协助服务,包括注册登录指导、实名认证材料审核支持、签名/模板申请咨询、免费调试技术协助等,帮助企业完成接口对接流程,确保服务正常开通。
