文档首页/云消息服务 KooMessage/API参考/API/智能信息服务号资料/更新服务号信息
更新时间：2025-01-06 GMT+08:00
查看PDF
分享

更新服务号信息

功能介绍

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

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

内部错误。

错误码

请参见错误码。

相关文档