手把手教你如何开发融云短信服务

概述

为满足应用中短信验证业务需求，融云与优质短信平台合作，提供具有全网覆盖能力的短信验证码发送、验证功能接口，详细开通及使用说明如下：

短信功能使用流程

开发者在使用短信验证功能前，需前往融云官方网站注册创建融云开发者帐号。

使用流程

短信服务使用说明

认证企业开发者

在融云开发者后台，选择需要开通短信功能的应用，进入应用详情页面，点击 “短信服务 > 服务设置” 进行企业认证，提交认证信息后，会在 5 个工作日内审核完成。

认证企业开发者

短信资费、扣费说明

认证成功后，需要充值购买短信才能使用短信服务，短信价格如下：

充值为 100 的整数倍例如：100, 200, 1100, 1200…

充值金额 < 1000 元时，短信单价为 0.060 元/条
1000 ≤ 充值金额 < 5000 元时，短信单价为 0.055 元/条
充值金额 ≥ 5000 元时，短信单价为 0.050 元/条
短信扣费说明：

金额充值成功后，实时兑换成相应短信条数。
短信条数将在短信发送后 48 小时内完成扣除，短信实际扣除条数以运营商结算为准。
长短信扣费规则：
短信总字数 ≤ 70 个字时，算一条。
短信总字数＞ 70 个字时，应扣条数 = 短信总字数 / 67，向上取整。例如 134 个字的短信将按两条扣费， 71 个字的短信，也将按 2 条扣费。
短信中的字母、数字、符号、空格都算一个字。

短信签名

每条短信都必须带有签名，可以在开发者后台 “短信服务 > 服务设置” 中进行添加。

签名说明

根据中国基础运营商的相关规定，每条短信的最后必须包含签名，如果没有签名，则短信肯定无法正常发送。
签名格式为中文括号加公司简称或者店铺名称等：例如：【融云即时通讯云】，建议使用 3-7 个汉字。
可以包含数字、汉字、英文，不能为纯数字、纯英文或数字+英文的组合，不能包含其他特殊符号。
签名会自动附加，因此会占用短信的字数，请注意控制内容长度。

图片验证

开发者可选择开启或关闭图片验证功能，开启后可通过获取图验接口获取图验 URL 地址，在发送短信验证码时会对图验进行验证，验证通过才会下发短信验证码，否则不会下发短信验证码，防止短信骚扰。

短信模板

融云默认为提供用户注册、密码找回、修改密码、身份验证、通用验证码等 5 个短信模板，如果用户有新的模板需求，可提交模板申请添加。

需要说明模板名称、短信用途及内容，短信内容中需要标出签名位置(只能在短信内容前面或最后)及验证码位置。

短信号码

短信号码说明

短信号码在每创建一个应用后，系统会自动分配一个短信端口号码。
因受政策限制，已分配的短信端口号码某些时候不可用。
暂不提供自定义短信号码。

获取图片验证码方法

开发者后台开通图片验证功能后，才能获取图片验证码。

示例

HTTP 请求方式: GET

http://api.sms.ronghub.com/getImgCode.json?appKey=uwd1c0sxdlx2
表单参数

名称类型说明
appKey String 应用 AppKey。（必传）
返回值

名称类型说明
code int 返回码，200 为正常。
url String 返回的图片验证码 URL 地址。
verifyId String 返回图片验证标识 Id。
json格式：

{
“code”: 200,
“url”: “xxxxxxxxxxxxx”,
“verifyId”: “xxxxxxxx”
}

发送短信验证码方法

方法名：/sendCode

签名方法：请参考通用 API 接口签名规则

URL：http://api.sms.ronghub.com/sendCode.json

HTTP 方法：POST

示例

HTTP 请求:

POST /sendCode.json HTTP/1.1
Host: api.sms.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/x-www-form-urlencoded

mobile=13500000000&verifyId=1408706337&verifyCode=890b422b&templateId=dsfdsfd&region=86
表单参数

名称类型说明
mobile String 接收短信验证码的目标手机号，每分钟同一手机号只能发送一次短信验证码。（必传）
verifyId String 图片验证标识 Id ，开启图片验证功能后此参数必传，否则可以不传。在获取图片验证码方法返回值中获取。
verifyCode String 图片验证码，开启图片验证功能后此参数必传，否则可以不传。
templateId String 短信模板 Id，在“开发者后台->短信服务->服务设置->短信模版”中获取。（必传）
region String 手机号码所属国家区号，目前只支持中国区号 86（必传）
返回值

名称类型说明
code int 返回码，200 为正常。
sessionId String 短信验证码唯一标识。
json格式：

{
“code”: 200,
“sessionId”: “xxxxxxx”
}
注：每分钟同一手机号只能发送一次短信验证码，短信验证码有效期为 15 分钟，短信验证成功后验证码失效。开通图片验证功能后，如果此条图片验证不成功则用户不会收到验证短信。
返回值请参考 API 方法返回值说明

验证码验证方法

方法名：/verifyCode

签名方法：请参考通用 API 接口签名规则

URL：http://api.sms.ronghub.com/verifyCode.json

HTTP 方法：POST

示例

HTTP 请求:

POST /verifyCode.json HTTP/1.1
Host: api.sms.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/x-www-form-urlencoded

sessionId=2312312&code=3122
表单参数

名称类型说明
sessionId String 短信验证码唯一标识，在发送短信验证码方法，返回值中获取。（必传）
code String 短信验证码内容。（必传）
返回值

名称类型说明
code int 返回码，200 为正常。
success Boolean true 验证成功，false 验证失败。
json格式：

{“code”:200,”success”:true}
返回值请参考 API 方法返回值说明

发送通知类短信方法

方法名：/sendNotify

签名方法：请参考通用 API 接口签名规则

URL：http://api.sms.ronghub.com/sendNotify.json

HTTP 方法：POST

示例

HTTP 请求:

POST /sendNotify.json HTTP/1.1
Host: api.sms.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/x-www-form-urlencoded

mobile=13500000000&templateId=dsfdsfd&region=86&p1=aa&p2=bb&p3=cc
表单参数

名称类型说明
mobile String 接收通知短信的目标手机号。（必传）
templateId String 短信模板 Id，在“开发者后台->短信服务->服务设置->短信模版”中获取。（必传）
region String 手机号码所属国家区号，目前只支持中国区号 86（必传）
p1 String 短信模板中，自定义变量值，如果在通知短信模板中定义了 {p1} 则在发送通知短信时必须传入此参数，替换模板中的 {p1}，否则此参数可以不传。
p2 String 短信模板中，自定义变量值，如果在通知短信模板中定义了 {p2} 则在发送通知短信时必须传入此参数，替换模板中的 {p2}，否则此参数可以不传。
p3 String 短信模板中，自定义变量值，如果在通知短信模板中定义了 {p3} 则在发送通知短信时必须传入此参数，替换模板中的 {p3}，否则此参数可以不传。
注：发送的所有短信内容（包括短信通知和短信验证码）不能超过 210 个字。

返回值
名称类型说明
code int 返回码，200 为正常。
sessionId String 短信唯一标识。

json格式：
{
“code”: 200,
“sessionId”: “xxxxxxx”
}
返回值请参考 API 方法返回值说明

API 方法返回值说明

code 描述 HTTP 状态码
1009 没有开启图验功能 400
1010 未使用已开启的图验功能 400
1000 内部逻辑错误 500
1003 参数错误 400
1005 参数长度超出限制 400
1008 调用超过频率上限 429
1002 缺少参数 400
1004 验证签名错误 401
1050 内部服务响应超时 504
1012 图片验证码不正确 430
1011 剩余条数不足，需要充值 430
1013 短信通道不可用 430
1014 短信验证码已验证过，再次验证失效 430
1015 短信验证码过期无效 430

手把手教你如何开发融云短信服务相关推荐

手把手教你如何使用阿里云短信API
1.官方提供的短信功能API public class SmsUtils {public static void main(String[] args) throws ClientException ...
PHP开发阿里云短信服务接口
PHP交流群:294088839 Python交流群:652376983 function sendSms($phone,$code){ // 基于TP3.2开发 //引进阿里的配置文件 Vendor ...
SpringBoot-短信验证码-快速入门Demo(含redis)（手把手教你开通阿里云短信服务到写出个最终代码来）
B站小狂神-此博客的内容就是看了这个视频的总结(博主自己写的哦~并非转载) 视频链接-[狂神说]通俗易懂的阿里云短信业务实战教程(露脸) 您是否还在为别人的项目有短信功能自己的却没有? 您是否还在为自 ...
手把手教你对接阿里云短信服务
正好双十二,最近在做一个小项目需要用到短信业务,注册了新用户125买了5000条短信,有效期2年. 那么如何对接阿里云短信,需要做哪些操作? 可以参考https://help.aliyun.com/d ...
手把手教你写一个获取短信验证码业务(基于Spring Boot+Redis+阿里云短信服务)
文章目录一.阿里云短信环境搭建 1.开启使用子用户,创建用户组和用户 2.开通阿里云短信服务二.环境测试 1.新建Spring Boot(web)项目,导入依赖 2.在测试类中进行测试三.真实业 ...
微信小程序云开发，使用阿里云短信服务，搜索员工生日定期发送短信。
相关API文档地址: 阿里云短信服务API文档地址小程序云开发云函数正则匹配API文档地址小程序云开发云函数定时触发器 1.登录阿里云,购买短信服务并添加签名和模板 2., 登录阿里云,鼠标放在右 ...
C/C++开发，阿里云短信服务接口的c++实现
目录一.阿里云短信服务接口二.逻辑代码实现三.编译测试效果一.阿里云短信服务接口最近在调用阿里云短信服务接口发现并没有c++的资料,网上查询发现也是零星描述,由于自身项目基础累积了C++的太 ...
阿里云短信服务详细说明与实战开发后端代码
文章目录 1.短信服务背景 2.短信发送流程 3.阿里云短信服务基本说明 3.1 开通阿里云短信服务与购买短信套餐包 3.2 短信服务帮助文档 3.3 手机短信模板介绍 3.3.1 基本说明 3.3. ...
接入腾讯云短信服务（史上最详细+该短信服务如何申请成功+发送短信验证码API讲解+相关错误分析）
2021/8/17/23:01{2021/8/17/23:01}2021/8/17/23:01 文章目录前言一.如何成功申请到腾讯云短信服务 1.签名申请 2.正文模板申请二.发送短信API开发 ...

手把手教你如何开发融云短信服务

手把手教你如何开发融云短信服务相关推荐

最新文章

热门文章