创蓝云智 API
    创蓝云智 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应用场景_变量短信
      • 调通短信接口
      • 变量短信发送
    • 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.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应用场景_普通短信
    下一页
    短信API接口列表
    Built with