关闭
立即体验

立即体验

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

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

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

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

发彩信 找维信!


发彩信 找维信!

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

个性化短信接口文档

608 2018-11-29 17:25:47 中昱维信

本文档仅使用于中昱维信个性化短信接口。PDF文档请点击下载

1.接口概览

1.1 个性化短信介绍

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

1.2 个性化短信组成

个性化短信模板

个性化短信模板是用户将要发送的短信内容模板,模板内容可以根据自己的需求定义,个性化短信模板全部需要符合国家法律法规的规定,违法违规的内容不能使用此模板,详情请见‘审核说明’。

创建个性化短信模板

新建个性化短信模板

发送个性化短信

发送时需要将已经创好的个性化短信模板ID,以及需要发送的变量,需要接收验证码的手机号码,和平台生成的ID,AppID,AppKey提交至接口

1.3 功能介绍

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

2.开始接入

2.1 接入说明

个性化短信属于收费功能,用户可按照自己的使用量自助购买短信条数。使用接口发送个性化短信时,需要提前进行模板报备,否则将无法提交。

注册登录中昱维信短彩信平台,可查看个性化短信接口接入指南、状态码参考、demo示例以及常见问题。(注:如需直接使用,可查看:个性化短信平台使用指南

个性化短信接口平台内容

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

个性化短信接口在线测试

2.2 接入流程

开始使用

用户在用中昱维信个性化短信之前需要在先注册账号,网址为https://vip.veesing.com

完成企业实名认证

完成了注册之后登录平台   打开系统设置==》账户资料,上传相应的企业资质

充值个性化短信服务

平台支持线下和线上充值,选择产品然后进行充值

获取账号

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

请求地址

https://vip.veesing.com/smsApi/custom

发送个性化短信

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

参数名称

含义

参数值

必填

appId

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

2RYN7CQHL1M*****

appkey

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

WVNA4A0*****

sendTime

发送时间

1

smsId

模板ID

 

content

提交的json字符串,需要

Mobile(手机号),variables(变量),这两个参数,前提是需要和创建的模板一一匹配,变量可以为数组。

详情见下方

接口提交参数示例

appId:WVNA4A******

content:[ { "mobile":手机号, "variables": [变量] } , { "mobile": 手机号, "variables": [ 变量] } ]

appKey:2RYN7CQHL1******

smsId:11

传两个变量值

[ { "mobile":15080929435, "variables": [13223,8888] }]

返回参数详解

returnStatus

返回状态

message

返回信息

remainpoint

返回余额

taskId

任务ID

successCounts

成功条数

(Sentid)

(可忽略)

正确返回参数实例

{

    "returnStatus": "2000 ",

    "message": "发送成功",

    "remainpoint": "241",

    "taskId": "3313746",

    "successCounts": "1",

    "sentid": "null"

}

错误返回参数实例

{

    "returnStatus": "4002 ",

    "message": "手机格式不正确",

    "remainpoint": "null",

    "taskId": "null",

    "successCounts": "0",

    "sentid": "null"

}

统一返回状态码

4000

账号或密码错误

4005

参数错误

4006

模板不存在或者未通过

4007

参数与模板不匹配

4004

签名不合法

4001

账户余额不足

4002

确手机号码格式不正确

4003

手机号码今日发送次数已达上限

4010

相同手机号码一分钟之内只可发送一次

2000

发送成功

4008

未知原因,请联系客服  (客服热线:400-68-10658

4012

数组格式错误

4010

账户被锁定

4200

未进行企业认证,只能发送系统默认模板

4080

定时时间必须大于当前时间30分钟以上

4081

定时时间不正确 例:2017-4-5 15:34:00

3.审核说明

企业审核

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

个性化短信模板审核

依据《中国人民共和国网络安全法》相关要求,用户使用必须遵循国家相关法律法规,不得发送违法信息,认证企业所编辑的个性化模板必须符合国家的法律法规,如含有违规信息的模板内容,根据情节严重做出相应处罚;如有不便,敬请谅解。

4.常见问题

个性化短信接收为什么会有延迟?

请检查手机状态是否正常,关机、无信号或者其他手机原因会导致接收延迟。请查看是否安全软件将其拦截

接口提交为什么一直提交不上去?

请仔细检查参数是否按要求填写,检查content的JSON字符串是否正确,检查提交的参数是否和模板的变量相匹配

接口一直返回4003是什么情况?

为了用户账户安全,发送验证码进行了发送次数限制,限制同一手机号,一天只允许发送5次,如需开发测试请换一不同的手机号进行接收验证码,如有不便,敬请谅解。

接口返回4007是什么意思?

参数与模板不匹配。传入的参数与提前报备模板的变量不匹配,请仔细检查传入的参数时候与报备的模板相匹配;如未解决请咨询中昱维信客服(客服热线:400-68-10658)

接口返回4006?

模板不存在或者未通过,请在中昱维信服务平台查看个性化模板是否已经添加成功,如未解决请咨询中昱维信客服(客服热线:400-68-10658)              

5.联系我们

联系电话 : 400-68-10658

E-mail : service@veesing.com

代理加盟 : 18019467159

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

双翼软件

客服热线:400-68-10658