更新时间:2023-08-21 GMT+08:00
分享

修改短信签名

功能介绍

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

URI

PUT /v1/sms/signatures/{signature_id}

表1 路径参数

参数

是否必选

参数类型

描述

signature_id

String

签名ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

signature_name

String

签名名称。

最小长度:2

最大长度:16

signature_type

String

签名类型。

最小长度:1

最大长度:20

枚举值:

  • PROMOTION_TYPE:营销类

  • NOTIFY_TYPE:通知类

app_id

String

短信应用ID。

最小长度:1

最大长度:50

apply_desc

String

申请说明。

最小长度:0

最大长度:80

file_id

String

营业执照文件ID。调用上传申请文件接口获取。

最小长度:1

最大长度:50

signature_source

Integer

签名来源。

枚举值:

  • 0:企事业单位的全称或简称

  • 1:工信部备案网站的全称或简称

  • 2:APP应用的全称或简称

  • 3:公众号或小程序的全称或简称

  • 4:电商平台店铺名的全称或简称

  • 5:商标名的全称或简称

is_involved_third

String

是否涉及第三方权益。若为yes,则还需要传入授权委托书。

最小长度:1

最大长度:10

枚举值:

  • yes:涉及

  • no:不涉及

power_attorney_file_id

String

授权委托书文件ID。调用上传申请文件接口获取。

最小长度:1

最大长度:50

source_title_content

String

签名来源标题内容,填写内容需和签名来源对应,具体如下。

  • 网站域名:仅当“签名来源”为“工信部备案网站的全称或简称”时,需要输入工信部备案网站域名,如huawei.com。

  • APP应用下载地址:仅当“签名来源”为“APP应用的全称或简称”时,需要填写。

  • 公众号或者小程序的全称:仅当“签名来源”为“公众号或小程序的全称或简称”时,需要填写。

  • 电商平台店铺地址:仅当“签名来源”为“电商平台店铺名的全称或简称”时,需要填写。

最小长度:1

最大长度:180

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

signature_id

String

签名ID。

signature_name

String

签名名称。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

结果状态码。

最小长度:0

最大长度:32

error_msg

String

结果详情。

最小长度:0

最大长度:32

状态码: 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

结果状态码。

最小长度:0

最大长度:32

error_msg

String

结果详情。

最小长度:0

最大长度:32

请求示例

修改ID为"dcd40c76-e72c-4f94-b677-******bbb69"的短信签名。

https://koomessage.myhuaweicloud.cn/v1/sms/signatures/dcd40c76-e72c-4f94-b677-******bbb69

{
  "signature_name" : "API创建测试签名",
  "signature_type" : "NOTIFY_TYPE",
  "app_id" : "36d93093-8941-4969-82e8-*****9b276",
  "apply_desc" : "签名申请说明",
  "file_id" : "cec80a6b-95b6-405b-bbab-*****2a022",
  "signature_source" : 0,
  "is_involved_third" : "no"
}

响应示例

状态码: 200

修改短信签名响应体。

{
  "signature_id" : "dcd40c76-e72c-4f94-b677-******bbb69",
  "signature_name" : "API创建测试签名"
}

状态码

状态码

描述

200

修改短信签名响应体。

400

非法参数。

500

内部错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品