关闭
立即体验

立即体验

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

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

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

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

发彩信 找维信!


发彩信 找维信!

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

短信验证码接口文档

31342 2019-08-15 10:51:25 中昱维信

1.接口概览

1.1 短信验证码介绍

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

1.2 短信验证码组成

短信签名

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

短信模板

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

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

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

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

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

1.3 功能介绍

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

2.开始接入

2.1 接入说明

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

注册登录中昱维信短彩信平台,左侧菜单栏“接口文档”--“短信验证码接口”,可查看短信api接口文档、状态码参考、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": "1 ",

    "message": "成功",

    "remainpoint": "241",

    "taskId": "3313746",

    "successCounts": "1"

}

错误返回示例:

{

    "returnStatus": "0 ",

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

    "remainpoint": null,

    "taskId": null,

    "successCounts": null

}

返回参数详解

returnStatus

返回状态

message

返回信息

remainpoint

返回余额

taskId

任务ID

successCounts

成功条数

统一返回状态码

1

发送成功

0

账号或密码错误

0

缺少参数

0

模板不存在或者未通过

0

模板id格式不正确

0

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

0

余额不足

0

手机号码格式不正确

0

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

0

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

0

当日发送量已超出最大发送限制

0

未知原因,请联系客服 

请求地址:

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

获取短信验证码产品余额

参数名称

含义

参数值

必填

appId

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

2RYN7CQHL1M*****

appKey

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

WVNA4A0*****

返回参数详解

returnStatus

返回状态

message

返回信息

remainpoint

返回余额

统一返回状态码

1

发送成功

0

账号或密码错误

0

缺少参数

0

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

0

未知原因,请联系客服 

0

ip受限


充值短信验证码服务

平台支持线下和线上充值,选择短信短信验证码产品,然后进行充值,线上支持:微信支付和支付宝支付。

完成企业实名认证

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

 

2.3 上行/回执推送

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

3.审核说明

3.1 企业审核

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

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

3.2 签名/内容模板

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

4.常见问题

接口一直返回该号码次数已达上限是什么情况?

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

接口返回参数与模板不匹配是什么意思?

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

接口返回模板不存在或者未审核通过

请在中昱维信服务平台查看签名是否已经创建成功 

5.联系我们

联系电话 : 400-68-10658

E-mail : service@veesing.com

代理加盟 : 18019467159

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

客服热线:400-68-10658