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

通道号绑定服务号

功能介绍

通道号绑定服务号。

URI

POST /v1/aim-sa/ports/associate

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

Content-Type

是

String

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

表2 请求Body参数

参数

是否必选

参数类型

描述

pub_id

是

String

服务号ID。

最小长度：0

最大长度：32

port

是

String

通道号。

  • port_type=5时，长度必须为5

  • port_type=1或3，长度在21位内

最小长度：0

最大长度：21

province

是

String

绑定的地区，不允许传入重叠地区。地区取值见《地区名称列表》。

最小长度：0

最大长度：500

sign

是

Array of strings

绑定签名，必须是该端口号签名的子集。单个签名长度为2-18。

数组长度：0 - 5

ext_port_id

是

String

关联通道号ID，取通道号列表返回的ID。

最小长度：32

最大长度：32

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

data

BindPortResponseBody object

通道号解绑服务号响应体。

表4 BindPortResponseBody

参数

参数类型

描述

message

String

信息。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

请求示例

通道号绑定服务号。通道号为"8822053111111"，服务号ID为"961b0f7d32314b5cb287fc06fe09cccc"。

https://koomessage.myhuaweicloud.cn/v1/aim-sa/ports/associate

{
  "pub_id" : "961b0f7d32314b5cb287fc06fe09cccc",
  "ext_port_id" : "a67928a301364aa38d8cf6f08242cccc",
  "port" : "8822053111111",
  "province" : "佛山市",
  "sign" : [ "华为云KooMessage" ]
}

响应示例

状态码： 200

返回信息。

{
  "data" : {
    "message" : "成功"
  }
}

状态码

状态码

描述

200

返回信息。

400

非法参数。

500

内部错误。

错误码

请参见错误码。

相关文档