普通短信

—、应用场景

验证码短信
接口可以实现给指定手机号发验证码短信，用短信验证码来验证操作者的身份，来确保是本人操作，或者是经由本人授权操作。

通知短信
短信在实用工具功能和修辞性事功能基础上又衍生出新的功能形态—文化评判与社会参与功能，而且在这种传媒体的引导和推动下，这种功能日益得到彰显和强化。

营销短信
发送一般用于不同行业、不同领域的企事业单位、团体组织机构对于自身产品的推广和介绍，达到加快速或加深沟通联系；提高服务质量；加快工作效率（包括商业销售效率）的手段

二、准备工作

使用我司接口，需要先注册我司账号，提交营业执照-即可正式使用，使用之前，建议先完成签名以及模板报备方便测试。（发送短信之前，必须提交签名;模板,不提交的话会进入人工审核，延长发送短信的时间）

开发阶段，建议先关闭IP鉴权功能，或将服务器IP及本地IP均设置在IP白名单内，避免请求验证失败

三、调通短信接口

1）提交方式：post请求

编码格式：UTF-8

Content-type：application/json

阅读文档了解API说明，下载demo快速使用，选择合适的发送接口

注：实际域名请在云通讯后台查看

2）发送接口

方法一：直接使用API

附注：因运营商政策，请先在后台完成报备签名、模板及做相关设置(详见接入引导)，再开发API。

URL：终端接入方式推荐https协议使用接口,短信请求务必采用IP鉴权（IP白名单）验证提交

3）请求参数

字段	参数释义	是否为必填参数	备注
account	创蓝API账号	是	具体的值可以登录我司官网zz.253.com，进入管理后台查看
password	创蓝API密码	是	具体的值可以登录我司官网zz.253.com，进入管理后台查看
msg	短信内容	是	长度不能超过536个字符，签名需要加在内容里，如：【253云通讯】您的验证码是123456
phone	手机号码	是	多个手机号码使用英文逗号分隔
sendtime	定时发送短信时间	否	格式为yyyyMMddHHmm，值小于或等于当前时间则立即发送，默认立即发送；且定时时间在7天以内
report	是否需要状态报告（默认false）	否	如需状态报告则传true（如需要状态报告和上行的拉取或者推送，必须为true）
extend	下发短信号码扩展码	否	纯数字，需保证手机端口号加自定义扩展码总位数不超过20位，建议1-3位，如需上行短信推送或拉取则必填
uid	该条短信在您业务系统内的ID	否	一般可以设置订单号或者短信发送记录流水号，用于区分短信业务，总位数不超过40位

4)请求格式

5)响应说明

响应数据格式：

字段说明：

time	响应时间
msgid	消息id
errorMsg	状态码说明（成功返回值）
code	状态码（”返回0为成功，失败的返回值请查看“验证码通知和营销短信提交响应状态码“）

四、实现业务逻辑

生成短信内容，调用发送接口传入（账号、密码、手机号、内容等参数）发送短信。

短信内容前面为，签名需要通过审核才能使用，模板如不匹配接口会进入人工审核，延缓发送速度。报错记录可以在管理后台查看

五**、按需开发功能**

对短信发送状态做实时监控
如果您需要通过程序对短信的发送状态做实时监控，可以开发“推送/获取状态报告”接口。如果只是想了解短信发送状态，无实时监控需求，"云通讯管理控制台—数据统计 " 可以看到实时及历史的到达率、发送量、接口失败原因等报表。

·短信平台/代理类客户如果您是短信平台/代理，需要管理众多客户的签名及模板。您可能需要“签名提交API”、“模板管理API”、“账户API”。从而通过API接口轻松管理签名、模板、账户。

·获取上行短信如果您的业务中，需获取用户回复的上行短信，可以开发“回送上行短信API”。通过这个接口，如果用户回复了您的短信，云通讯会第一时间推送给您

1.3应用场景_普通短信

普通短信#

—、应用场景#

二、准备工作#

三、调通短信接口#

2）发送接口#

**URL：**终端接入方式推荐https协议使用接口,短信请求务必采用IP鉴权（IP白名单）验证提交#

3）请求参数#

4)请求格式#

5)响应说明#

四、实现业务逻辑#