修改短信签名 - UpdateSignature
功能介绍
该接口用于用户更新签名信息,目前仅支持审核不通过的短信签名重新修改。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/msgsms/signatures/{id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 签名主键ID,对应表5 响应SmsSignatureResp参数中的ID |
| project_id | 是 | String | 项目ID,参考“获取帐号、用户、项目的名称和ID” |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 请求体参数类型,该字段必须设置为:application/json;charset=utf8 |
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| app_id | 是 | String | 应用主键ID,参考表5 响应SmsAppQueryResp参数中的ID |
| apply_desc | 否 | String | 申请说明 |
| file_id | 否 | String | 营业执照文件ID,表5的file_id |
| is_involved_third | 是 | String | 是否涉及第三方权益
|
| power_attorney_fileid | 否 | String | 授权委托书文件ID,表5的file_id |
| signature_name | 是 | String | 签名名称 |
| signature_source | 是 | Integer | 签名来源
|
| signature_type | 是 | String | 签名类型
|
| source_title_content | 否 | String | 签名来源标题内容(已废弃) |
| qualification_id | 是 | String | 资质ID,当前考虑存量应用的接口兼容性,代码未做强制校验,但修改签名时请务必携带资质ID,否则会导致资质审核失败 |
| signature_related_file_id | 否 | String | 签名关联性截图 当签名来源为“商标名的全称“时传商标证书截图ID 截图ID通过上传申请文件API获取。 |
| registration_number | 否 | String | 商标申请/注册号,当签名来源为“商标名的全称“时传入 |
响应参数
状态码: 200
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 否 | String | 签名主键ID |
| signature_id | 否 | String | 签名ID |
| signature_name | 否 | String | 签名名称 |
请求示例
修改短信签名详情,请求方式:PUT,请求URL:/v2/{project_id}/msgsms/signatures/{id},路径参数:id,project_id,请求头参数:X-Auth-Token,Content-Type;请求体参数:app_id,is_involved_third,signature_name,signature_source,signature_type、qualification_id。
PUT /v2/845ada5bc7444f1295cd517af0123da1/msgsms/signatures/eb55ddeb-76f3-4e07-94f4-9af775f8a9a7
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":"******93-e9e4-4fa9-b9eb-6424f4974c4b",
"is_involved_third":"No",
"signature_name":"auto_test789",
"signature_source":"0",
"signature_type":"NOTIFY_TYPE"
} 响应示例
{
"id": "******eb-76f3-4e07-94f4-9af775f8a9a7",
"signature_id": "******d9-660c-4bd5-ad59-d4be6af32667",
"signature_name": "auto_test789"
} 返回值
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 201 | Created |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | System error |