创蓝云智 API
  1. 1.3使用场景
创蓝云智 API
  • 创蓝短信API文档介绍
  • 开发引导
  • 1.2.1调用说明
  • 1.2.2DEMO下载
  • 1.2.3常见问题
  • PHP DEMO
  • C# DEMO
  • Asp DEMO
  • go demo
  • Node.js DEMO
  • Python DEMO
  • java DEMO
  • 1.3应用场景_普通短信
  • 1.3应用场景_变量短信
  • 短信API接口列表
  • 1.6.1返回码示例
  • 1.6.2.1接口返回码
  • 1.6.2.2个性化接口返回码
  • 1.6.2.3定制接口返回码
  • 1.6.3.1国际接口响应码
  • 1.7.1服务协议
  • 开发引导
  • 1.2.1调用说明
  • 1.2.2DEMO下载
  • 1.2.3常见问题
  • PHP DEMO
  • C# DEMO
  • Asp DEMO
  • go demo
  • Node.js DEMO
  • Python DEMO
  • java DEMO
  • 1.3应用场景_普通短信
  • 1.3应用场景_变量短信
  • 短信API接口列表
  • 1.6.1返回码示例
  • 1.6.2.1接口返回码
  • 1.6.2.2个性化接口返回码
  • 1.6.2.3定制接口返回码
  • 1.6.3.1国际接口响应码
  • 1.7.1服务协议
  • 短信API接口列表
  • 短信API接口列表
  • 1.1介绍
    • 创蓝短信API文档介绍
  • 1.2开发引导
    • 开发引导
    • 1.2.1调用说明
    • 1.2.2DEMO下载
    • 1.2.3常见问题
    • 1.2.4代码示例
      • PHP DEMO
      • C# DEMO
      • Asp DEMO
      • go demo
      • Node.js DEMO
      • Python DEMO
      • java DEMO
  • 1.3使用场景
    • 1.3应用场景_普通短信
    • 1.3应用场景_变量短信
    • 调通短信接口
      POST
    • 变量短信发送
      POST
  • 1.4国内短信
    • 短信API接口列表
    • 相同内容群发接口
    • 相同内容变量接口
    • 余额查询接口
    • 回送上行明细接口
    • 拉取上行明细接口
    • 拉取状态报告
    • 回送状态报告
  • 1.5国际短信
    • 国际短信发送
      • 国际短信单条发送接口
      • 国际短信群发送接口
    • 推送明细说明
      • 推送状态报告
      • 推送上行明细
    • 拉取明细说明
      • 拉取状态报告
      • 拉取上行明细
  • 1.6返回码说明
    • 1.6.1返回码示例
    • 1.6.2国内接口返回码
      • 1.6.2.1接口返回码
      • 1.6.2.2个性化接口返回码
      • 1.6.2.3定制接口返回码
    • 1.6.3国际接口返回码
      • 1.6.3.1国际接口响应码
  • 1.7协议
    • 1.7.1服务协议
  1. 1.3使用场景

1.3应用场景_变量短信

变量短信发送#

—.应用场景#

用于验证码通知短信和营销短信内容里含有变量的短信的发送,丰富了短信使用的种类。

二.准备工作#

使用我司接口,需要先注册我司账号,提交营业执照之后,即可正式使用,使用之前,建议先完成签名以及模板的报备,方便之后测试。(发送短信之前,必须提交签名;模板可以不提交发送短信,但是不提交的话会进入人工审核,延长发送短信的时间)。
开发阶段,建议先关闭IP白名单,或将服务器IP及本地IP均设置在IP白名单内。

三.接口的调试#

1)提交方式:post请求
编码格式:UTF-8
Content-type:application/json
阅读文档了解API说明,下载demo快速使用,选择合适的发送接口
注:实际域名请在云通讯后台查看
2)**URL:**终端接入方式推荐https协议使用接口,短信请求务必采用IP鉴权(IP白名单)验证提交#
3)请求参数#
字段参数释义是否为必填参数备注
account创蓝API账号是具体的值可以登录我司云通讯后台查看
password创蓝API密码是具体的值可以登录我司云通讯后台查看
msg短信内容是长度不能超过536个字符,签名需要加在内容里, 如:【253云通讯】欢迎联调创蓝短信接口
params手机号码是手机号码和变量参数,多组参数使用英文分号;区分,必填
sendtime定时发送短信时间否格式为yyyyMMddHHmm,值小于或等于当前时间则立即发送,默认立即发送;且定时时间在7天以内
report是否需要状态报告(默认false)否如需状态报告则传true(如需要状态报告和上行的拉取或者推送,必须为true)
extend下发短信号码扩展码否纯数字,需保证手机端口号加自定义扩展码总位数不超过20位,建议1-3位,如需上行短信推送或拉取则必填
uid该条短信在您业务系统内的ID否一般可以设置订单号或者短信发送记录流水号,用于区分短信业务,总位数不超过40位
4)请求格式#
PS:params参数组的具体格式:参数组从左往右第一个为发送的手机号码,第二个为第一个变量,第三个为第二个变量,以此类推,变量的数目需要和内容里变量的数目(msg里的{$var})一一对应。
5)响应说明#
响应数据格式:
字段说明:#
failNum失败条数
time响应时间
successNum成功条数
msgid消息id
errorMsg状态码说明(成功返回值)
code状态码(返回0为成功,失败的返回值请查看“验证码通知和营销短信提交响应状态码”)

四、实现业务逻辑#

生成短信内容,调用发送接口,传入账号、密码、手机号、内容等参数发送内容里有变量的短信。
短信内容中,签名需要通过审核才能使用,模板如不匹配接口会进入人工审核,延缓发送速度。报错记录可以在管理后台查看。

【创蓝云智】API开发者 微信交流群

用微信扫右侧二维码,加入【创蓝云智】API开发者 交流群,互助沟通

扫码加入交流群
上一页
1.3应用场景_普通短信
下一页
调通短信接口
Built with