
# 创建短信签名 - CreateSignature
#### 功能介绍
该接口用于用户创建签名。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/MSGSMS/doc?api=CreateSignature)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/msgsms/signatures
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                       |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，参考"[获取帐号、用户、项目的名称和ID](https://support.huaweicloud.com/api-msgsms/sms_05_0020.html)" |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                      |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 请求体参数类型，该字段必须设置为：application/json;charset=utf8          |
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） |
   
表3请求Body参数 
| 参数                        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| app_id                    | 是    | String  | 应用主键ID，参考[表5 响应SmsAppQueryResp参数](https://support.huaweicloud.com/api-msgsms/sms_05_0022.html#ZH-CN_TOPIC_0000001380032914__table133082032111715)中的ID                                                                                                                                                                                                                                                                                                                 |
| apply_desc                | 否    | String  | 申请说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| file_id                   | 否    | String  | 营业执照文件ID，[表5](https://support.huaweicloud.com/api-msgsms/sms_05_0035.html#ZH-CN_TOPIC_0000001379872934__table13677852175715)的file_id                                                                                                                                                                                                                                                                                                                                  |
| is_involved_third         | 是    | String  | 是否涉及第三方权益 - Yes：是  - No：否                                                                                                                                           |
| power_attorney_fileid     | 否    | String  | 授权委托书文件ID，[表5](https://support.huaweicloud.com/api-msgsms/sms_05_0035.html#ZH-CN_TOPIC_0000001379872934__table13677852175715)的file_id                                                                                                                                                                                                                                                                                                                                 |
| signature_name            | 是    | String  | 签名名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| signature_source          | 是    | Integer | 签名来源 - 0：企事业单位的全称或简称  - 5：商标名的全称                                                                                                                                         |
| signature_type            | 是    | String  | 签名类型 - VERIFY_CODE_TYPE：验证码类  - PROMOTION_TYPE：推广类  - NOTIFY_TYPE：通知类   |
| source_title_content      | 否    | String  | 签名来源标题内容（已废弃）                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| qualification_id          | 是    | String  | 资质ID，当前考虑存量应用的接口兼容性，代码未做强制校验，但创建签名时请务必携带资质ID，否则会导致资质审核失败                                                                                                                                                                                                                                                                                                                                                                                                              |
| signature_related_file_id | 否    | String  | 签名关联性截图 当签名来源为"商标名的全称"时传商标证书截图ID 截图ID通过[上传申请文件](https://support.huaweicloud.com/api-msgsms/sms_05_0035.html)API获取。                                                                                                                                                                                                                                                         |
| registration_number       | 否    | String  | 商标申请/注册号，当签名来源为"商标名的全称"时传入                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
#### 响应参数
状态码： 200
表4响应Body参数 
| 参数             | 参数类型   | 描述     |
|:---|:---|:---|
| id             | String | 签名主键ID |
| signature_id   | String | 签名ID   |
| signature_name | String | 签名名称   |
   
#### 请求示例
创建短信签名，请求方式POST，请求URI：/v2/{project_id}/msgsms/signatures，路径参数：project_id，请求头参数：X-Auth-Token，Content-Type；请求体参数：app_id，is_involved_third，signature_name，signature_source，signature_type、qualification_id。
```
POST /v2/845ada5bc7444f1295cd517af0123da1/msgsms/signatures 
Host: 100.85.***.***:30300
Content-Type: application/json
X-Auth-Token:******
Content-Length: 245
 
{
"app_id":"******9c-1a6b-4ee5-9651-5bca450694b3",
"apply_desc":"test",
"qualification_id":"******ab-1390-4268-9463-73db98cdc2e1",
"is_involved_third":"No",
"signature_name":"auto_test789",
"signature_source":"0",
"signature_type":"NOTIFY_TYPE"
}
```
#### 响应示例
```
{
    "id": "******bb-d48c-4c4d-b3da-baa8e4664852",
    "signature_id": "******d1-196f-495f-abbe-42240469b8fc",
    "signature_name": "auto_test789"
}
```
#### 返回值
| 返回值 | 描述           |
|:---|:---|
| 200 | OK           |
| 201 | Created      |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
| 500 | System error |
   
