关闭
立即体验

立即体验

立即体验
服务类型:
手机号:
验证:
短信内容:

【中昱维信】您的验证码是:****。请不要把验证码泄露给其他人。

您的验证码是:****。

【中昱维信】假日来袭,福利送不停!您有两张代金券已到账,
请注意查收。

发彩信 找维信!


发彩信 找维信!

彩信内容承载量大,形式丰富,是政府企业手机报
和会员维护的优选媒体,支持:
●图文彩信 ●音频彩信
●视频彩信 ●国际彩信
9年专业服务,品质保证,咨询热线:400-68-10658

彩信群发接口文档

9512 2019-07-23 17:30:55 中昱维信

1.接口概览

1.1彩信群发介绍

中昱维信彩信群发专用接口,拥有专业的技术和稳定的平台,优质的通道资源,7*24 小时服务监控等优势

1.2彩信组成

创建彩信

用户群发彩信时首先需要调用接口创建彩信,创建彩信需要将发送的彩信标题,彩信内容,以及平台生成的AppId,AppKey提交至接口,接口完成处理之后返回创建的彩信ID。

发送彩信

发送彩信时需要将已经创建好的彩信ID,和需要发送的手机号码,和平台生成的AppID,AppKey,发送时间提交至接口

1.3 功能介绍

本文档主要提供给中昱维信平台的用户对接接口的使用说明,开发者可以利用中昱维信提供的HTTP 接口,调用中昱维信的创建彩信,群发彩信服务。

2.开始接入

2.1 接入说明

彩信服务属于收费功能,用户可按照自己的使用量自助购买短信条数。创建彩信时,提交的内容大小不能超过100KB,建议在60K左右。发送彩信时单次向接口提交的手机号码不能超过2000。彩信群发接口分为创建彩信和发送彩信。

注册登录中昱维信短彩信平台,左侧菜单栏“接口文档”--“彩信&手机报接口”,可查看彩信API接口文档、状态码参考、demo示例以及常见问题。(注:如需直接使用,可查看:彩信群发平台使用指南

中昱维信短彩信平台还可进行在线彩信群发接口测试,位置在左侧栏目列表中的“常用工具”--“功能&接口测试”--彩信群发接口测试

2.2接入流程

用户接入中昱维信彩信群发平台一共需要 5 个步骤,具体步骤如下

开始使用

中昱维信彩信群发首先需要在中昱维信官网注册账号,官网右上角登录/注册。

获取接入账号

从平台获取注册账号的AppID和AppKey

请求地址

https://vip.veesing.com/mmsApi/create

使用接口创建彩信

创建彩信请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口。请求应答过程中使用的中文编码格式为UTF-8。

参数名称

含义

参数值

必填

appId

平台自动生成的唯一账户标识

2RYN7CQHL1M*****

appkey

平台自动生成的唯一账户标识

WVNA4A0*****

content

提交彩信内容(内容格式请看下方说明)

title

彩信标题

UTF-8编码标题

提交彩信内容格式要求

包括类型,文字和图片,图片格式为base64,文字信息格式为gb2312,帧与帧之间用;分隔。每个资源内部包含多个类型信息,分别是:播放时间,类型 | 内容(按字节码base64编码), 类型 | 内容(按字节码base64编码),每一帧资源类型和内容之间以 | 隔开,每一个帧可以有多个资源类型和内容,同一帧之间用半角逗号(,)分隔。

完整创建彩信POSTDATA案例

appKey:**************&appId:**********&customerid:1&content=3,txt|zsSxvg==,jpg|4AAQSkZJRgABAgAAZABk;3,gif|ExghIhcXGRcXIiQdIB8fIB0kJCssLywrJDk5Pj45OUFBQ

正确返回参数实例

注意:taskId即为用户创建的彩信ID

{

 "returnStatus": "1",

"message": "成功",

"remainpoint": null,

"taskId": "55",

"successCounts": "1"

}

 错误返回参数实例

{

"returnStatus": "0",

"message": "缺少参数",

"remainpoint": null,

"taskId": null,

"successCounts": null

}

统一返回参数

1

成功

0

缺少参数

0

账号或密码错误

0

您的账户已被锁定,请联系您的专属客服

0

创建失败,请检查彩信报文是否正确

0

未知原因,请联系客服


使用接口发送彩信

创建彩信请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是:https://vip.veesing.com/mmsApi/send

参数名称

含义

参数值

必填

appId

平台自动生成的唯一账户标识

2RYN7CQHL1M*****

appKey

平台自动生成的唯一账户标识

WVNA4A0*****

mmsId

返回的彩信taskID

456

sendTime

发送时间

定时发送时间 如2013-05-15 00:00:00 若不填写表示立即发送

phone

手机号码

下发信息的手机号码,可以是多个手机号,手机号之间用逗号分隔

正确返回参数实例

注意:taskId即为用户发送的彩信ID

{

 "returnStatus": "1",

"message": "成功",

"remainpoint": "2357",

"taskId": "55",

"successCounts": "1"

}

 错误返回参数实例

{

"returnStatus": "0",

"message": "缺少参数",

"remainpoint": null,

"taskId": null,

"successCounts": null

}

统一返回参数

1

f成功

0

账号或密码错误

0

缺少参数

0

您的账户已被锁定,请联系您的专属客服

0

模板id格式不正确

0

模板不存在或未通过审核

0

定时时间格式不正确

0

请确保定时发送时间大于当前时间30分钟及以上

0

余额不足

0

未知原因,请联系客服

2.3彩信群发回执推送

用户如需获取彩信群发对回执推送,请在系统配置里面添加接收推送的服务器地址。

回执推送参数    

{

"mobile": "1508092****",

"taskid": "123",

"status": "0",

 "receivetime": "2019-07-23 17:00:00"

}

mobile

电话号码

taskid

发送id

status

失败为0,成功为1

receivetime

接收时间


充值彩信群发产品

平台支持线下和线上充值,选择彩信群发产品,线上支持:微信支付和支付宝支付。

完成企业实名认证

依《中华人民共和国网络安全法》相关要求,平台账号必须完成真实身份信息认证后,才可正常使用相关服务。未认证左侧菜单栏上方“企业资质未认证”,点击进行资质认证。注:资质认证信息包括:公司名称、公司简称、公司地址、营业执照和企业logo。



3.审核说明

企业审核

依据《中华人民共和国网络安全法》相关要求,平台账号必须完成真实身份信息认证后,才可正常使用相关服务,感谢您的理解和支持!用户正式使用本平台所有服务之前,需要先提供企业营业执照(正本或副本)的复印件加盖公章(公章需彩色),然后在【首页】-【账户资料】里面完成实名认证。

彩信内容

依据《中国人民共和国网络安全法》相关要求,用户使用必须遵循国家相关法律法规,不得发送违法信息,平台所有彩信内容必须严格遵守法律法规,如含有违规信息的彩信,企业会被永久禁封,敬请谅解。

4.常见问题

彩信发送提交之后为什么没收到?

每一条彩信都需要经过后台通道排队,具体情况视当时彩信通道情况为准,约为30分钟之内可完成发送;彩信提交至运营商通道后,如果运营商通道拥挤,则会有延迟。

彩信图片应该怎么设置?

彩信图片最小的标准是176*143px(像素),随着智能手机的普及,在彩信体积不超出的前提下彩信的宽度可以扩展至大于250像素小于400像素的区间。

5.联系我们

联系电话 : 400-68-10658

E-mail : service@veesing.com

代理加盟 : 18019467159

地址 : 上海市浦东新区金科路2966号1幢211室

客服热线:400-68-10658