修改短信签名
功能介绍
该接口用于用户更新签名信息,目前仅支持审核不通过的短信签名重新修改。
调试
您可以在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通过上传申请文件API获取。 |
|
registration_number |
否 |
String |
商标申请/注册号,当签名来源为“商标名的全称“时传入 |
|
license_number |
否 |
String |
ICP备案/许可证号,当签名来源为“APP应用的全称“时传入 |
响应参数
状态码: 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 |