关闭
立即体验

立即体验

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

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

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

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

发彩信 找维信!


发彩信 找维信!

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

短信验证码接口文档

1986 2018-10-25 15:20:25 中昱维信

本文档仅适用于中昱维信短信验证码接口。PDF文档请点击下载

1.接口概览

1.1 短信验证码介绍

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

1.2 短信验证码组成

短信签名

短信签名是加在短信的开头或结尾,在【】里面加上您的公司名称或店铺名称的标识符,例如:【中昱文化】。 根据电信基础运营商的规定,每条短信必须附加短信签名,否则将无法正常发送。注意:未付费用户仅可使用默认短信签名【中昱文化】,付费用户可以通过点击左侧导航【触发消息服务】-【服务总览】-【接入信息】修改签名,一定时间之后即可正式使用。

短信模板

用户使用中昱维信短信验证码时,需要创建短信验证码模板,即您要发送的短信进行相似性提取后的内容,举个例子:、

【短信签名】您好,您的验证码为【变量】,请勿将验证码泄露给他人。

【短信签名】您好,您在【变量】平台进行注册操作,您的验证码为【变量】。

【中昱文化】您好【变量】,您的验证码为【变量】,请妥善保管。

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

1.3 功能介绍

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

2.开始接入

2.1 接入说明

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

注册登录中昱维信短彩信平台,可查看短信验证码接口文档、状态码参考、demo示例和产常见问题。

短信验证码平台接口内容

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

注:短彩信平台注册登录在网站右上角,平台使用方法可查看:短信验证码接入指南

2.2 接入流程

开始使用

用户在用中昱维信短信验证码之前需要在先注册账号,官网右上角登录/注册即可。

完成企业实名认证

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

充值短信验证码服务

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

获取账号

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

请求地址

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

发送短信验证码

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

参数名称

含义

参数值

必填

appId

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

2RYN7CQHL1M*****

appKey

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

WVNA4A0*****

phone

接收验证码得手机号码

1508092****

templateId

模板ID

用户创建的模板ID

variables

变量

变量与变量用;隔开

 

正确返回示例:

{

    "returnStatus": "2000 ",

    "message": "发送成功",

    "remainpoint": "241",

    "taskId": "3313746",

    "successCounts": "1",

    "sentid": "null"

}

错误返回示例:

{

    "returnStatus": "4002 ",

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

    "remainpoint": "null",

    "taskId": "null",

    "successCounts": "0",

    "sentid": "null"

}

 

返回参数详解

returnStatus

返回状态

message

返回信息

remainpoint

返回余额

taskId

任务ID

successCounts

成功条数

(Sentid)

(可忽略)

统一返回状态码

4000

账号或密码错误

4005

参数错误

4006

模板不存在或者未通过

4007

参数与模板不匹配

4004

签名不合法

4001

账户余额不足

4002

确手机号码格式不正确

4003

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

4010

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

2000

发送成功

4008

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

4010

账户被锁定

4200

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

2.3 上行/回执推送

用户如需获取短信验证码上行推送/验证码回执推送,请在系统配置里面添加接收推送的服务器地址。

3.审核说明

3.1 企业审核

依据《中华人民共和国网络安全法》相关要求,平台账号必须完成真实身份信息认证后,才可正常使用相关服务,感谢您的理解和支持!

用户正式使用本平台所有服务之前,需要先提供企业营业执照(正本或副本)的复印件加盖公章(公章需彩色),然后在【首页】-【账户资料】里面完成实名认证。

3.2 签名/内容模板

依据《中国人民共和国网络安全法》相关要求,用户使用必须遵循国家相关法律法规,不得发送违法信息,平台所有内容模板/签名必须符合国家法律法规的要求,如含有违规信息的验证码模板/签名,将被永久禁封;如有不便,敬请谅解。

4.常见问题

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

请检查是否已经加上签名。

例如:签名模板【中昱维信】,一般为公司名称或品牌名称。

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

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

接口返回4007是什么意思?

参数与模板不匹配

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

接口返回4006?

模板不存在或者违规,请在中昱维信服务平台查看签名是否已经创建成功 

5.联系我们

联系电话 : 400-68-10658

E-mail : service@veesing.com

代理加盟 : 18019467159

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

客服热线:400-68-10658