jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云短信短信模板示例

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 审核规范 >短信模板示例

#  短信模板示例

最近更新时间: 2021-01-25 14:41:13

您可根据实际业务需求、短信模板示例和[短信模板审核标准
__](https://developer.qiniu.com/sms/manual/6648/sample-text-
template)创建符合规范的短信模板，若不做任何修改，可以极大提高审核效率及成功率。

# **模板示例**

类型| 应用场景| 模板示例  
---|---|---  
验证码类| 注册| 您正在申请手机注册，验证码为：${code}，5分钟内有效！  
尊敬的用户，您的注册会员动态密码为：${code}，请勿泄漏于他人！  
登陆/验证| 您的验证码为：${code}，该验证码5分钟内有效，请勿泄漏于他人！  
您的验证码：${code}，您正进行身份验证，打死不告诉别人！  
您的验证码为：${code}，请尽快完成验证。祝您生活愉快！  
验证码为：${code}，您正在登录，若非本人操作，请勿泄露。  
重置密码| 您的动态验证码为：${code}，您正在进行密码重置操作，如非本人操作，请忽略本短信！  
找回密码| 您正在进行密码找回，验证码为：${code}，5分钟有效，请勿向任何人提供此验证码。  
变更信息| 验证码为：${code}，您正在尝试变更重要信息，请妥善保管账户信息。  
通知类| 修改密码| 您好，您的密码已经重置为${password}，请及时登录并修改密码。  
审核| 您的${mtname}申请已于${submittime}审批通过，特此通知。  
快递| 尊敬的${name}用户，您的提货码是：${code}，请不要把提货码泄露给其他人。  
您好，请凭取件码：${code}，至${address}取件，若有问题请咨询${phone}。  
您的快递${code}正在配送中，请注意查收。  
排队| 您的排队号${code}，您前面还有${number}人等待，请在现场等候叫号。  
订单| 您有新的订单待处理，当前状态：${status}，订单摘要:${remark}，请及时处理。  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信国内短信

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >国内短信

#  国内短信

最近更新时间: 2021-12-29 21:49:20

七牛云提供云短信服务SMS（Short Message Service，SMS）支持向国内快速发送验证码、短信通知和营销推广短信。

# 国内短信发送步骤

发送国内短信，请遵循以下步骤：

  1. 添加签名。  
短信签名必须遵循[短信签名审核标准 __](https://developer.qiniu.com/sms/manual/5816/signature-
specification)，且经过审核。

  2. 添加模板。  
短信模板必须遵循[短信模板审核标准 __](https://developer.qiniu.io/sms/manual/5814/template-
specification)，且经过审核。

  3. 发送短信。  
通过[短信服务API __](https://developer.qiniu.com/sms/manual/5824/through-the-api-
send-text-messages)发送短信。  
通过[控制台批量发送 __](https://developer.qiniu.com/sms/manual/5823/the-console-send-
sms)短信。

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信国际/港澳台短信

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >国际/港澳台短信

#  国际/港澳台短信

最近更新时间: 2021-12-30 10:28:49

七牛云提供云短信服务SMS（Short Message Service，SMS）支持向国际/港澳台快速发送验证码、短信通知和营销推广短信。

# 国际/港澳台短信发送步骤

发送国内短信，请遵循以下步骤：

  1. 添加签名。  
短信签名必须遵循[短信签名审核标准 __](https://developer.qiniu.com/sms/manual/5816/signature-
specification)，且经过审核。

  2. 添加模板。  
短信模板必须遵循[短信模板审核标准 __](https://developer.qiniu.io/sms/manual/5814/template-
specification)，且经过审核。

  3. 发送短信。  
通过[短信服务API __](https://developer.qiniu.com/sms/manual/5824/through-the-api-
send-text-messages)发送短信。  
通过[控制台批量发送 __](https://developer.qiniu.com/sms/manual/5823/the-console-send-
sms)短信。

# 国际/港澳台短信模板说明

如您需要发送国际/港澳台短信，请注意国际短信语言支持说明：

发送目的国家与地区 | 支持模板语言  
---|---  
中国港澳台 | 简体中文、繁体中文、英文  
日本 | 日文、英文  
韩国 | 韩文、繁体中文、英文  
  
其它国家只支持英文

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信签名管理

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >签名管理

#  签名管理

最近更新时间: 2020-03-02 15:48:54

简单的列举了短信签名控制台和API的功能。

# **控制台介绍**

功能 | 描述  
---|---  
新建签名 | 控制台[创建签名](https://portal.qiniu.com/sms/signature)，创建时可参考签名审核标准。  
查询签名 | 根据签名审核状态和签名内容定位签名  
  
# **API介绍**

功能 | 描述  
---|---  
创建签名 | [API方式创建签名](https://developer.qiniu.io/sms/api/5844/sms-api-create-signature)  
列出签名 | [API方式列举签名](https://developer.qiniu.io/sms/api/5889/sms-api-query-signature)  
查询单个签名 | [API方式查询单个签名](https://developer.qiniu.io/sms/api/5970/query-a-single-signature)  
编辑签名 | [API方式编辑签名](https://developer.qiniu.io/sms/api/5890/sms-api-edit-signature)  
删除签名 | [API方式删除签名](https://developer.qiniu.io/sms/api/5891/sms-api-delete-signature)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信模板管理

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >模板管理

#  模板管理

最近更新时间: 2020-03-02 17:15:32

简单的列举了短信模板控制台和API的功能。

# **控制台介绍**

功能 | 描述  
---|---  
新建模板 | 控制台[创建模板](https://portal.qiniu.com/sms/template)，创建时可参考签名审核标准。  
查询模板 | 可根据关联签名、模板审核状态和模板内容定位模板  
  
# **API介绍**

功能 | 描述  
---|---  
创建模板 | [API方式创建签名](https://developer.qiniu.io/sms/api/5844/sms-api-create-template)  
列出模板 | [API方式列举签名](https://developer.qiniu.io/sms/api/5889/sms-api-query-template)  
查询单个模板 | [API方式查询单个签名](https://developer.qiniu.io/sms/api/5970/query-a-single-template)  
编辑模板 | [API方式编辑签名](https://developer.qiniu.io/sms/api/5890/sms-api-edit-template)  
删除模板 | [API方式删除签名](https://developer.qiniu.io/sms/api/5891/sms-api-delete-template)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信通过API发送短信

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >发送短信 >通过API发送短信

#  通过API发送短信

最近更新时间: 2021-09-16 11:53:21

# **前提条件**

  1. 已开通短信服务。
  2. 已添加短信签名和短信模板并通过审核

# **API发送接口**

接口 | 描述  
---|---  
发送短信 | 发送单条或者群发短信：[/v1/message（POST方式） __](https://developer.qiniu.com/sms/api/5897/sms-api-send-message#1)  
发送单条短信 | [/v1/message/single __](https://developer.qiniu.com/sms/api/5897/sms-api-send-message#2)  
发送国际短信 | [/v1/message/oversea __](https://developer.qiniu.com/sms/api/5897/sms-api-send-message#3)  
发送全文本短信(不需要传模版 ID) | [/v1/message/fulltext __](https://developer.qiniu.com/sms/api/5897/sms-api-send-message#4)  
  
# **查询发送记录**

  * [/v1/messages（GET 方式） __](https://developer.qiniu.com/sms/api/5852/query-send-sms)

# **回调消息**

分为状态回调和上行回调。

详情请参考[消息推送 __](https://developer.qiniu.com/sms/api/5910/message-push#1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信通过控制台批量发送短信

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >发送短信 >通过控制台批量发送短信

#  通过控制台批量发送短信

最近更新时间: 2020-03-02 17:05:12

# **前提条件**

  1. 已开通短信服务。
  2. 已添加短信签名和短信模板并通过审核
  3. 控制台批量发送**需审核开通** ，可[提交工单](https://support.qiniu.com/tickets/new)或者联系对应商务经理。
  4. 只支持**推广、通知短信模板** ，如有其他需求也可以提交工单。

# **操作步骤**

  1. 进入[短信控制台](https://portal.qiniu.com/sms/send)，选择“发送任务> 批量发送”。
  2. 填写任务名称。
  3. 选择短信模板，如果没有模板，可添加先添加短信签名。
  4. 设置接收号码。可选择**导入接收号码文件** 或**手动输入接收号码。**
  5. 定时发送（可选）：选择群发短信任务发送时间。

![](https://dn-odum9helk.qbox.me/FqtBA4L2gQS0-yO8midW52QHLoQN)

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信配置管理

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >短信设置 >配置管理

#  配置管理

最近更新时间: 2020-03-03 14:43:30

在配置管理中，您可以通过填写回调地址的方式来接收短信的发送状态回调和上行短信内容回调。

# **设置消息推送**

![](https://dn-odum9helk.qbox.me/FtMRFqZgLowbqio34vLj1D00aBi5)

  1. 打开[云短信控制台 ](https://portal.qiniu.com/sms/settings)-> 配置管理
  2. 填写业务回调地址

说明：

  1. 业务回调地址仅支持带 http、https 协议的 URL 格式。
  2. 回调方法都是HTTP POST，且返回 HTTP 状态码 200，如果返回不是 200，会在10分钟内自动重试。

# **发送状态回调**

短信发送给用户后，将会通过回调下列 URL 的方式，通知业务方用户发送短信的状态。

**回调内容**

    
    
    {
        "items":[{
            "mobile": <string>,
            "message_id": <string>, // 
            "status": <string>, // DELIVRD 送达， FAILED 发送失败
            "delivrd_at": <timestamp>,
            "error": <string>, 
            "job_id": <string> 
        }]
    }
    

**参数解析：**

参数 | 说明  
---|---  
mobile | 手机号码  
message_id | 单条发送的时候返回的 message_id  
status | DELIVRD 送达， FAILED 发送失败  
delivrd_at | 到达时间  
error | 当 status 为 FAILED 的时候，会有这个字段  
job_id | 批量发送的时候返回的 job_id  
  
# **上行状态回调**

用户回复短信，将会通过回调下列 URL 的方式，通知业务方用户回复了短信。

    
    
    {
        "items": [{
            "mobile": "<string>",
            "content": "<string>",
            "time": <timestamp>
        }]
    }
    

**参数解析：**

参数 | 说明  
---|---  
mobile | 手机号码  
content | 回复的具体内容  
time | 回复时间  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信余量提醒和阈值设置

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >短信设置 >余量提醒和阈值设置

#  余量提醒和阈值设置

最近更新时间: 2021-07-27 16:10:42

系统设置包含余额提醒和发送阈值两个子功能。

说明：

  1. 配置好预警提示后需到[联系人设置控制台 __](https://portal.qiniu.com/sms/contacts)添加**主账户以外** 的余额提醒和发送阈值联系人，可参考说明文档[联系人设置。 __](https://developer.qiniu.com/sms/manual/5832/contacts)

# **余量提醒**

在系统设置的余量提醒中，您可以对已购买的资源包分别针对系统短信资源包（验证码和通知类）或者推广短信资源包分别设置提醒下限。  
![](https://dn-odum9helk.qbox.me/FobtiSJuaw7gOUtfLmOCoSHMOssr)

开启该功能后，我们会在您的短信资源包条数低于您设置的条数时，免费向您发送短信或邮件提醒。  
为避免因资源包不足对您的业务造成不良影响，建议您开启资源包余量提醒功能。

**开启方式**

  1. 打开[短信控制台 __](https://portal.qiniu.com/sms/system)-> 系统设置 -> 余额提醒
  2. 在当前状态栏点击开启按钮后，根据业务需求填写提醒条数，建议设置为资源包的30%。

# **发送阈值**

在系统设置的发送阈值中，支持对每日和每月的**短信发送总量和模板发送总量** 设置预警值及限额值。

  * 达到预警值时，预设的联系人会收到系统发送的短信提醒；
  * 达到限额值，系统暂停短信发送。

该功能是您根据日常情况进行的发送上限设置，设置后可避免网站被人恶意利用，导致短信量突增，而产生高额费用。  
![](https://dn-odum9helk.qbox.me/FraWo0ZTdIX1O2x5fvq9gwQu5j1p)  
![](https://dn-odum9helk.qbox.me/FtLwvH44SH_bmYDr26buc4nra4aq)

说明：

  1. 达到预警值及限额值，系统会发送短信提醒到手机号。达到限额值时，系统暂停短信发送，需要您手动更改。
  2. 模板阈值高于账户总量阈值，请优先设置模板发送总量阈值。

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信联系人设置

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >短信设置 >联系人设置

#  联系人设置

最近更新时间: 2020-03-03 11:36:00

# **联系人设置**

余额提醒和发送阈值的通知提醒会以短信和邮件的方式通知，根据业务需要添加多个联系人，可确保重要信息的及时查阅。

# **操作步骤**

  1. 打开短信控制台，在左侧导航栏中单击**联系人管理** 。
  2. 点击新建联系人。

![](https://dn-odum9helk.qbox.me/FvetKaKtIFGMmmoJCqWrwV30_PSj)

配置 | 说明  
---|---  
姓名 | 联系人的姓名  
手机号 | 联系人的手机号码，11位数字  
邮箱 | 联系人的邮箱  
用户资源包余额提醒 | 该联系人是否接收套资源余量预警短信和邮件  
账户发送总量阈值 | 该联系人是否接收账户发送总量阈值预警短信和邮件  
模板发送总量阈值 | 该联系人是否接收模板发送总量阈值预警短信和邮件  
  
说明：

  1. 默认情况下，联系人中只有主账号联系人，主账号联系人默认接收余额提醒和发送阈值提醒，且不可变更。**账号管理** 中可更换主账号联系人。

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信防短信轰炸

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 用户指南 >防短信轰炸

#  防短信轰炸

最近更新时间: 2020-03-02 18:53:47

# **背景信息**

短信轰炸主要是利用验证码攻击，通过⽤户产品验证码获取的接⼝，通过**自动化脚本⽅式**
批量对单个或者多个号码进⾏验证码重复请求提交，⽤户验证码被刷后直接带来的是经济损失，同时对被攻击的号码带来了巨⼤的骚扰。

# **解决措施**

措施描述 | 具体方式 | 解决的问题  
---|---|---  
使用安全图片验证码 | 点击获取验证码之前做一个校验，比如需要正确输入图形验证码、拖动验证等 | 防止通过自动化工具进行攻击请求  
单IP的请求次数限定 | 在服务器端增加对单ip请求的验证码数量进行限制，一般情况下建议不超过 200 个/分钟。 | 防止攻击者对服务器进行大量无效请求  
单用户动态短信请求间隔时长限制 | 客户在服务器端对单手机号请求的验证码时长和数量进行限制，一般是60 秒后，超出60秒没有输入的验证码作废，重新获取。 | 防止图片验证码失效后对用户形成大量攻击  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信短信业务授权书

gpt: [云短信](https://developer.qiniu.com/sms) > 使用文档 > 短信业务授权书

#  短信业务授权书

最近更新时间: 2024-08-23 17:32:23

# **背景**

如果用户 A 创建自用签名，签名归属主体属于用户 A ，则不涉及第三方权益。  
当申请的签名与公司主体或账号主体信息不一致时，需要额外提交短信业务授权书。比如用户 A 替用户 B 创建签名，签名归属主体属于用户 B
，则涉及第三方权益，需要 B 给予 A 的授权委托书。B 为授权方，A 为被授权方，并需要加盖 B 的公章。您可在这里下载授权书模板，进行填写盖章。  

# **授权书下载**

[点击下载授权书](https://dn-
odum9helk.qbox.me/%E6%8E%88%E6%9D%83%E5%A7%94%E6%89%98%E4%B9%A620240822.docx)  

![](https://dn-
odum9helk.qbox.me/%E6%8E%88%E6%9D%83%E5%A7%94%E6%89%98%E4%B9%A620240822.docx)

**注意：蓝色字体为提示，需去除后再填写相关内容**

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信查询发送计费条数

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 查询发送计费条数

#  查询发送计费条数

最近更新时间: 2021-03-09 17:00:59

# 接口介绍

短信字数 ≤ 70 个字数，按照 70 个字数一条短信计算，短信字数 > 70 个字数，即为长短信，按照 67
个字数记为一条短信计算，接口统计的为实际计费条数。

# 请求定义

    
    
    GET /v1/user/statistics HTTP 1.1
    Host: sms.qiniuapi.com
    Authorization: \<QiniuToken\>
    Content-Type: application/x-www-form-urlencoded
    

# 请求头

> 请参考 [请求认证 __](https://developer.qiniu.com/sms/5842/sms-api-authentication)

# 参数

名称 | 必填 | 描述  
---|---|---  
`start` | 是 | 查询开始时间。格式：2006-01-02  
`end` | 是 | 查询结束时间。格式：2006-01-02  
`g` | 是 | 计量数据聚合粒度，支持： day, 5min  
`status` | 是 | 短信的状态，支持：“success”(发送成功), “failed”(发送失败), “sending”(发送中)  
  
# 请求示例

> GET
> https://sms.qiniuapi.com/v1/user/statistics?start=2021-01-01&end=2021-01-02&g=day&status=success

# 响应定义

该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "data": {
            "marketing": { // 营销短信统计
                "times": [
                    1609430400,
                ],
                "values": [
                    0,
                ]
            },
            "notification": { // 通知短信统计
                "times": [
                    1609430400,
                ],
                "values": [
                    0,
                ]
            },
            "verification": {// 验证码短信统计
                "times": [
                    1609430400,
                ],
                "values": [
                    0,
                ]
            },
            "voice": { // 语音短信统计
                "times": [
                    1609430400,
                ],
                "values": [
                    0,
                ]
            }
        }
    }
    

说明： 通知短信和验证码短信会统一到 系统短信 计量计费

出错是响应如下 JSON 数据：

    
    
    {
        "error": "{error_type}",
        "message": "{error_message}",
        "request_id": "{request_id}"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信API简介

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > API简介

#  API简介

最近更新时间: 2019-05-14 15:29:25

本文档为您展示短信服务所有可调用的 API 接口，详细接口信息请参考对应接口文档。

服务域名： <https://sms.qiniuapi.com>  
接口鉴权：[请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

接口 | 请求类型 | 说明  
---|---|---  
[v1/signature](https://developer.qiniu.com/sms/api/5844/sms-api-create-signature) | POST | 创建签名  
[v1/signature](https://developer.qiniu.com/sms/api/5889/sms-api-query-signature) | GET | 查询签名  
[v1/signature/:id](https://developer.qiniu.com/sms/api/5890/sms-api-edit-signature) | PUT | 编辑签名  
[v1/signature/:id](https://developer.qiniu.com/sms/api/5891/sms-api-delete-signature) | DELETE | 删除签名  
[v1/template](https://developer.qiniu.com/sms/api/5893/sms-api-create-template) | POST | 创建模板  
[v1/template](https://developer.qiniu.com/sms/api/5894/sms-api-query-template) | GET | 查询模板  
[v1/template](https://developer.qiniu.com/sms/api/5895/sms-api-edit-template) | UPDATE | 编辑模板  
[v1/template](https://developer.qiniu.com/sms/api/5896/sms-api-delete-template) | DELETE | 删除模板  
[v1/message](https://developer.qiniu.com/sms/api/5897/sms-api-send-message) | POST | 发送消息  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云短信服务鉴权

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 服务鉴权

#  服务鉴权

最近更新时间: 2019-06-27 18:05:46

# 请求认证 (Authentication)

## API 服务域名：

    
    
    https://sms.qiniuapi.com
    

每一个请求均需在 HTTP 请求头部增加一个 Authorization 字段，其值为符合管理凭证的字符串，形式如下：

    
    
    Authorization: <QiniuToken>
    

`<QiniuToken>`: 管理凭证，用于鉴权。

# 生成管理凭证：

    
    
    // golang
    
    // 构造待签名的 Data
    // 1. 添加 Path
    data = "<Method> <Path>"
    
    // 2. 添加 Query，前提: Query 存在且不为空
    if "<RawQuery>" != "" {
            data += "?<RawQuery>"
    }
    
    // 3. 添加 Host
    data += "\nHost: <Host>"
    
    // 4. 添加 Content-Type，前提: Content-Type 存在且不为空
    if "<Content-Type>" != "" {
            data += "\nContent-Type: <Content-Type>"
    }
    
    // 5. 添加回车
    data += "\n\n"
    
    // 6. 添加 Body，前提: Content-Length 存在且 Body 不为空，同时 Content-Type 存在且不为空或 "application/octet-stream"
    bodyOK := "<Content-Length>" != "" && "<Body>" != ""
    contentTypeOK := "<Content-Type>" != "" && "<Content-Type>" != "application/octet-stream"
    if bodyOK && contentTypeOK {
            data += "<Body>"
    }
    
    // 计算 HMAC-SHA1 签名，并对签名结果做 URL 安全的 Base64 编码
    sign = hmac_sha1(data, "Your_Secret_Key")
    encodedSign = urlsafe_base64_encode(sign)
    
    // 将 Qiniu 标识与 AccessKey、encodedSign 拼接得到管理凭证
    <QiniuToken> = "Qiniu " + "Your_Access_Key" + ":" + encodedSign
    

## 示例：

    
    
    GET /v1/message HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: Qiniu 7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:PGTUV-oRxWAIl6mdneJPSJieyyQ=
    Content-Type: application/x-www-form-urlencoded
    Accept-Encoding: gzip
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信创建签名

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 签名管理 >创建签名

#  创建签名

最近更新时间: 2019-07-18 10:41:08

# 创建签名 (POST Signature)

## 请求定义

    
    
    POST /v1/signature HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求包

    
    
    {
        "signature": string,
        "source": string,
        "pics": []string
    }
    

参数名称 | 类型 | 必填 | 说明  
---|---|---|---  
signature | string | 是 | 签名  
source | string | 是 | 签名来源，申请签名时必须指定签名来源。取值范围为：  

  * `enterprises_and_institutions` 企事业单位的全称或简称
  * `website` 工信部备案网站的全称或简称
  * `app` APP应用的全称或简称
  * `public_number_or_small_program` 公众号或小程序的全称或简称
  * `store_name` 电商平台店铺名的全称或简称
  * `trade_name` 商标名的全称或简称

  
pics | []string | 否 | 签名对应的资质证明图片进行 base64 编码格式转换后的字符串  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "signature_id": <signature_id>
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信列出签名

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 签名管理 >列出签名

#  列出签名

最近更新时间: 2019-07-18 10:44:13

# 查询签名 (GET Signature)

## 请求定义

    
    
    GET /v1/signature HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求参数

该接口定义以下请求参数:

名称 | 必填 | 描述  
---|---|---  
audit_status | 否 | 审核状态, 取值范围为: "passed"(通过), "rejected"(未通过), "reviewing"(审核中)  
page | 否 | 页码。默认为 1  
page_size | 否 | 分页大小。默认为 20  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "items": [{
            "id": string,
            "signature": string,
            "source": string,
            "audit_status": string,
            "reject_reason": string,
            "created_at": int64,
            "updated_at": int64
        }...],
        "total": int,
        "page": int,
        "page_size": int,
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信查询单个签名

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 签名管理 >查询单个签名

#  查询单个签名

最近更新时间: 2019-07-18 10:37:54

# 查询单个签名信息

## 请求定义

    
    
    GET /v1/signature/{id} HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求参数

该接口定义以下请求参数:

参数名称 | 必填 | 描述   
---|---|---  
id | 是 | 签名ID信息  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "id": string,
        "signature": string,
        "source": string,
        "audit_status": string,
        "reject_reason": string,
        "created_at": int64,
        "updated_at": int64
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信编辑签名

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 签名管理 >编辑签名

#  编辑签名

最近更新时间: 2019-07-18 10:44:34

# 编辑签名 (PUT Signature)

审核不通过的情况下才可以重新编辑签名，已经审核通过的签名无法重新编辑。

## 请求定义

    
    
    PUT /v1/signature/:id HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求数据

该接口定义以下请求数据:

    
    
    {
        "signature": string
    }
    

## 响应定义

### 该接口正确处理请求时返回 HTTP 状态码

  * 服务器端正确处理请求时响应 HTTP 状态码 200

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信删除签名

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 签名管理 >删除签名

#  删除签名

最近更新时间: 2019-07-18 10:45:14

# 删除签名 (DELETE Signature)

## 请求定义

    
    
    DELETE /v1/signature/:id HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

## 响应定义

### 该接口正确处理请求时返回 HTTP 状态码

  * 服务器端正确处理请求时响应 HTTP 状态码为 200

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信创建模板

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 模板管理 >创建模板

#  创建模板

最近更新时间: 2022-12-06 17:36:52

# 创建模板 (POST Template)

## 请求定义

    
    
    POST /v1/template HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求数据

    
    
    {
        "name": string,
        "template": string,
        "type": string,
        "description": string,
        "signature_id": string,
        "is_oversea": bool
    }
    

参数名称 | 类型 | 必填 | 说明  
---|---|---|---  
name | string | 是 | 模板名称  
template | string | 是 | 模板内容 可设置自定义变量，发送短信时候使用，参考:${code}  
type | string | 是 | 模板类型，取值范围为: `notification` (通知类短信), `verification` (验证码短信), `marketing` (营销类短信), `voice`(语音类短信)  
description | string | 是 | 申请理由简述  
signature_id | string | 是 | 已经审核通过的签名  
is_oversea | bool | 否 | 是否是 国际/港澳台 模版  
  
### 模板示例

类型 | 示例  
---|---  
验证码短信 | 1\. 您的验证码是 ${code} （5分钟内有效）  
通知短信 | 1\. 库存告急通知，商品：${title}，库存不足，当前库存数：${quantity}  
2\. 主机告警，${ip} 当前磁盘剩余 ${ratio}，已使用 ${usage} GB，共计 ${total} GB  
营销短信 | 1\. 没赶上618？七牛云年中大促，狂欢到月底！存储秒杀低至0.001元/G，云主机0元抢，另有多款产品5折起，每日限量购，手慢无！https://dwz.cn/VjNhsExH  
2\. 汽油会员最高优惠1元，会员日汽油最高优惠1.2元！每周四周日会员日享更多优惠，详情请到站咨询!  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
    		"template_id": string
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信列出模板

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 模板管理 >列出模板

#  列出模板

最近更新时间: 2019-07-18 10:46:11

# 查询模板 (GET Template)

## 请求定义

    
    
    GET /v1/template HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求参数

该接口定义以下请求参数:

参数名称 | 必填 | 描述   
---|---|---  
audit_status | 否 | 审核状态, 取值范围为: `passed` (通过), `rejected` (未通过), `reviewing` (审核中)  
page | 否 | 页码。默认为 1  
page_size | 否 | 分页大小。默认为 20  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
      "items": [{
            "id": string,
            "name": string,
            "template": string,
            "audit_status": string,
            "reject_reason": string,
            "type": string,
            "signature_id": string, // 模版绑定的签名ID
            "signature_text": string, // 模版绑定的签名内容
            "created_at": int64,
            "updated_at": int64
        }...],
        "total": int,
        "page": int,
        "page_size": int
    
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信查询单个模版

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 模板管理 >查询单个模版

#  查询单个模版

最近更新时间: 2019-07-16 20:20:29

# 查询单个模版信息

## 请求定义

    
    
    GET /v1/template/{id} HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求参数

该接口定义以下请求参数:

参数名称 | 必填 | 描述   
---|---|---  
id | 是 | 模版ID信息  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "id": string,
        "name": string,
        "template": string,
        "audit_status": string,
        "reject_reason": string,
        "type": string,
        "signature_id": string, // 模版绑定的签名ID
        "signature_text": string, // 模版绑定的签名内容
        "created_at": int64,
        "updated_at": int64   
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信编辑模板

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 模板管理 >编辑模板

#  编辑模板

最近更新时间: 2019-07-18 10:52:37

# 编辑模板 (PUT Template)

审核不通过的情况下才可以重新编辑模板，已经审核通过的模板无法重新编辑。

## 请求定义

    
    
    PUT /v1/template/:id HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求数据

该接口定义以下请求数据:

    
    
    {
        "name": string,
        "template": string,
        "description": string,
        "signature_id": string
    }
    

参数名称 | 类型 | 必填 | 说明  
---|---|---|---  
name | string | 是 | 模板名称  
template | string | 是 | 模板内容  
description | string | 是 | 申请理由简述  
signature_id | string | 是 | 已经审核通过的签名  
  
## 响应定义

### 该接口正确处理请求时返回 HTTP 状态码

  * 服务器端正确处理请求时响应 HTTP 状态码 200

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信删除模板

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 模板管理 >删除模板

#  删除模板

最近更新时间: 2019-07-18 10:52:50

# 删除模板 (DELETE Template)

## 请求定义

    
    
    DELETE /v1/template/:id HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

## 响应定义

### 该接口正确处理请求时返回 HTTP 状态码

  * 服务端正确处理请求时响应 HTTP 状态码 200

以上内容是否对您有帮助？