# 通道号绑定服务号
#### 功能介绍
通道号绑定服务号。
#### 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           | 绑定的地区，不允许传入重叠地区。地区取值见[《地区名称列表》](https://support.huaweicloud.com/api-koomessage/um9003.html)。 最小长度：**0** 最大长度：**500** |
| sign        | 是    | Array of strings | 绑定签名，必须是该端口号签名的子集。单个签名长度为2-18。 数组长度：**0 - 5**                                                                        |
| ext_port_id | 是    | String           | 关联通道号ID，取通道号列表返回的ID。 最小长度：**32** 最大长度：**32**                                                                         |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数   | 参数类型                                                                           | 描述           |
|:---|:---|:---|
| data | [BindPortResponseBody] object | 通道号解绑服务号响应体。 |
   
 表4BindPortResponseBody 
| 参数      | 参数类型   | 描述  |
|:---|:---|:---|
| 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 | 内部错误。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koomessage/ErrorCode.html)。