更新服务号信息
功能介绍
支持用户更新服务号信息。
URI
POST /v1/aim-sa/pubs/{pub_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
pub_id |
是 |
String |
服务号ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Content-Type |
是 |
String |
请求体参数类型,该字段必须设置为:application/json。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 最大值:11 |
areas_for_auto_get_port |
否 |
Array of strings |
自动收集端口生效的地区列表。地区取值见《地区名称列表》。
说明:
auto_get_port为1时,该字段有效。不填则默认全国,不允许传入重叠地区。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
data |
UpdatePubResponse object |
更新服务号信息响应体。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
结果详情。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
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 |
内部错误。 |
错误码
请参见错误码。