视频短信http/https对接
1、签名报备
1.1 请求地址
地址:https://ip_address:port/mms/sign
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON
提示
秒信通视频短信多平台布署,对接前请联系秒信通客服索取IP地址/网址和端口号(ip_address:port)
1.2 请求参数
1.3 请求响应
2、获取签名审核状态
2.1 请求地址
地址:https://ip_address:port/mms/sign-status
请求头Content-Type:application/x-www-form-urlencoded
请求方式:Get 返回值:JSON
2.2 请示参数
2.3 请示响应
3、模板报备
3.1 请求地址:
地址:https://ip_address:port/mms/template
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON
3.2 请求参数
信息
模版content格式说明
多个帧之间以英文;分隔
每一帧以"3,"开头,之后的数据用英文,分隔
数据用英文|分隔,|前是上传的文件类型,|后是文件的base64编码数据
如果是变量文本,则占位符是${Text},比如:尊敬的${Text}您好
支持格式txt, gif, jpg, mp3, mp4, 3gp
例:3,txt|5rWL6K+V5LiA5LiL;3,txt|5rWL6K+V5LiA5LiL,mp4|3i/Zy9/g1ttOfqUy0JRTw8YuI3CyKPV
3.3 请求响应
4、获取模版审核状态
4.1 请求地址
地址:https://ip_address:port/mms/template-status
请求头Content-Type:application/x-www-form-urlencoded
请求方式:Get 返回值:JSON
4.2 请求参数
4.3 请求响应
5、模板视频短信发送
5.1 请求地址
地址:https://ip_address:port/mms/send-temp
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON
5.2 请求参数
5.3 请求响应
6、变量模板视频短信发送
6.1 请求地址
地址:https://ip_address:port/mms/send-personal
请求头Content-Type:application/x-www-form-urlencoded
请求方式:POST 返回值:JSON
6.2 请求参数
6.3 请求响应
7、获取状态报告
7.1 请求地址
地址:https://ip_address:port/mms/report
请求头Content-Type:application/x-www-form-urlencoded
请求方式:Get 返回值:JSON
7.2 请求参数
7.3 请求响应
8、推送状态报告(每条短信仅推送一次)
注意事项:推送使用的是POST方式,utf8原始字节流
推送格式:扩展号,调用发送接口返回的msg_id,手机号,状态,时间,售价 字段以,分隔 多条记录以|分隔
内容示范:123,2,1762532xxxx,DELIVRD,2021-12-23 01:02:03,0.2|123,2,17862532xxxx,DELIVRD,2021-12-23 01:02:03,0.1
9、获取用户上行回复(比如退订等,每条短信状态仅可获取一次)
9.1 请求地址
地址:https://ip_address:port/api/get-reply
请求方式:GET 返回值:JSON
手机回复上行后,此接口就能拉取到上行数据,每个上行数据只能拉取到一次,所以调用者拉到上行后,需要将上行的内容存在本地,然后自行根据 msg_id,手机号 等信息匹配具体哪条短信产生的上行回复
9.2 请求参数
9.3 请求响应
10、推送用户上行回复(每条上行回复仅推送一次)
注意事项:推送的是POST方式,utf8原始字节流
推送格式:urlencode后的内容,手机号,扩展号,时间 字段以,分隔多条记录以|分隔
内容示范:R,15811423517,411630,20250104142457|TD,15811423518,411631,20250104142457