更新时间:2024-10-24 GMT+08:00
分享

修改短信签名

功能介绍

该接口用于用户更新签名信息,目前仅支持审核不通过的短信签名重新修改。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v2/{project_id}/msgsms/signatures/{id}

表1 路径参数

参数

是否必选

参数类型

描述

id

String

签名主键ID,对应表5 响应SmsSignatureResp参数中的ID

project_id

String

项目ID,参考“获取帐号、用户、项目的名称和ID

请求参数

表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参数中的id

apply_desc

String

申请说明

file_id

String

营业执照文件ID,表5的file_id

is_involved_third

String

是否涉及第三方权益

  • Yes:是
  • No:否

power_attorney_fileid

String

授权委托书文件ID,表5的file_id

signature_name

String

签名名称

signature_source

Integer

签名来源。支持枚举值:

  • 0:企事业单位的全称或简称
  • 1:工信部备案网站的全称或简称
  • 2: APP应用的全称或简称
  • 3:公众号或小程序的全称或简称
  • 4:电商平台店铺名的全称或简称
  • 5:商标名的全称或简称

signature_type

String

签名类型。支持枚举值:

  • VERIFY_CODE_TYPE:验证码类
  • PROMOTION_TYPE:推广类
  • NOTIFY_TYPE:通知类

source_title_content

String

签名来源标题内容

qualification_id

String

资质ID,当前考虑存量应用的接口兼容性,代码未做强制校验,但修改签名时请务必携带资质ID,否则会导致资质审核失败

响应参数

状态码: 200

表4 响应Body参数

参数

是否必选

参数类型

描述

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

相关文档