更新时间:2024-11-22 GMT+08:00
分享

更新服务号信息

功能介绍

支持用户更新服务号信息。

URI

POST /v1/aim-sa/pubs/{pub_id}

表1 路径参数

参数

是否必选

参数类型

描述

pub_id

String

服务号ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

Content-Type

String

请求体参数类型,该字段必须设置为:application/json。

表3 请求Body参数

参数

是否必选

参数类型

描述

change_reason

String

更新原因。

最小长度:1

最大长度:200

logo_img

String

服务号LOGO图片资源ID。

说明:

通过上传智能信息服务号图片资源接口上传LOGO图片后获得的图片resource_id。图片要求大于等于240*240且比例相同。

最小长度:32

最大长度:32

authorization_files

Array of strings

授权证明图片资源ID,最多支持6张。

数组长度:0 - 6

pub_name

String

服务号名称。

最小长度:1

最大长度:15

pub_abstract

String

服务号简介。

最小长度:1

最大长度:75

pub_remark

String

服务号备注。

最小长度:1

最大长度:15

auto_get_port

Integer

自动获取端口。

最小值:0

最大值:1

signs_for_auto_get_port

Array of strings

自动收集端口使用的签名列表。

说明:

auto_get_port为1时,该字段为必填,每个签名长度须为2-18个字符,每个服务号签名不可以重复。

数组长度:0 - 5

industry

Integer

从事行业,默认取服务号所属商家的行业分类。

  • 1:金融理财

  • 2:社交通讯

  • 3:影音娱乐

  • 4:旅游出行

  • 5:购物

  • 6:本地生活

  • 7:运动健康

  • 8:教育培训

  • 9:新闻阅读

  • 10:运营商

  • 11:其他

最小值:1

最大值:11

areas_for_auto_get_port

Array of strings

自动收集端口生效的地区列表。地区取值见《地区名称列表》

说明:

auto_get_port为1时,该字段有效。不填则默认全国,不允许传入重叠地区。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

data

UpdatePubResponse object

更新服务号信息响应体。

表5 UpdatePubResponse

参数

参数类型

描述

data

data object

请求成功返回的数据,为JSON格式。

表6 data

参数

参数类型

描述

pub_update_log_id

String

可使用该ID查询当前记录审核情况。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

请求示例

根据服务号ID更新服务号信息。设置修改原因为"修改名称",修改服务号名称为"尊享酷玩"。

https://koomessage.myhuaweicloud.cn/v1/aim-sa/pubs/29333b06990f4a5ca3b13ffb0c67cccc

{
  "pub_name" : "尊享酷玩",
  "pub_remark" : "仅测试使用",
  "pub_abstract" : "尊享酷玩的摘要",
  "logo_img" : "6245269fa0214a81b55f12ec3c81cccc",
  "auto_get_port" : 1,
  "authorization_files" : [ "f3335e54b86145409cacfac4bf17cccc" ],
  "industry" : 2,
  "signs_for_auto_get_port" : [ "华为云KooMessage" ],
  "change_reason" : "修改名称"
}

响应示例

状态码: 200

返回信息。

{
  "data" : {
    "data" : {
      "pub_update_log_id" : "10202"
    }
  }
}

状态码

状态码

描述

200

返回信息。

400

非法参数。

500

内部错误。

错误码

请参见错误码

相关文档