问答 > 视频短信/彩信接口如何开发?

视频短信/彩信接口如何开发?

视频短信/彩信接口开发需包含以下核心参数,具体如下表所示:

参数名称参数值描述示例类型必填
api_idAPIID(用户中心【富媒体短信】-【5G视频短信】-【产品总览】查看)mms-xxxxxxxxstring
signature请求验证加密签名(非彩信签名);签名生成方式:仅公共参数以ASCII码从小到大排序值,key=value,多值以“&”隔开,拼接之后md5 32位小写;APIKEY可在用户中心【富媒体短信】-【5G视频短信】-【产品总览】查看xxxxxxxxxstring
timestamp东八时区;10位时间戳,时间允许相差±60S。1623643787int
request_id请求方请求ID,建议使用唯一ID(如uuid);系统会2小时内去重验证处理xxxxxxxxxxxxstring
product_id产品ID1001int
phone手机号数组(最多1万个号码)[\\\"136xxxxxxxx\\\",\\\"139xxxxxxxx\\\"]array
sign_name彩信签名(template_id未填写则必填)xxxxxxxxstring
title彩信标题(template_id未填写则必填)xxxxxxxxxxxxstring
content彩信内容和模板ID必须传入1个;当两者都传入时,内容生效,模板ID失效;内容为DataItem结构数组[{\\\"con_type\\\":\\\"txt\\\",\\\"ext_type\\\":\\\"\\\",\\\"data\\\":\\\"base64编码内容\\\,{\\\"con_type\\\":\\\"img\\\",\\\"ext_type\\\":\\\"jpg\\\",\\\"data\\\":\\\"base64编码图片\\\]array
template_id模板ID(content为空则必填)1int
send_time定时发送时间2020-08-26 16:08:14string

签名是请求验证的加密串,生成方式为:将公共参数按ASCII码从小到大排序,以key=value形式拼接,多参数用“&”分隔,再对拼接后的字符串进行MD5 32位小写加密。例如:md5(api_id=xxxx&api_key=xxxx&request_id=xxxxxxxx×tamp=xxxxxxx)。其中APIKEY需从用户中心【富媒体短信】-【5G视频短信】-【产品总览】获取。

接入视频短信/彩信接口需依次完成以下步骤:
1. 注册登录:在线自助注册并登录用户中心;
2. 实名认证:提交企业认证材料完成实名认证;
3. 签名/模板申请:签订合作协议后,提交模板及签名审核;
4. 接口对接:获取api_id、APIKEY等参数,参照文档进行接口开发调试;
5. 正式使用:审核通过后,使用接口发送视频短信/彩信。互亿无线提供相关接口的技术文档及支持,用户可通过其平台获取详细对接指导。

在视频短信/彩信接口开发中,content(彩信内容)与template_id(模板ID)需满足以下规则:两者必须传入其中一个;若同时传入,content生效,template_id属性失效。content需按DataItem结构组织,包含con_type(内容类型,如txt、img)、ext_type(文件扩展名,如jpg)、data(原始内容的base64编码)等字段。模板ID则对应预审核通过的固定模板,使用时无需重复传入内容结构。

在线咨询
电话咨询

4008 808 898 (9:00-18:00)

互亿无线公众号