# 查询接入码（queryAccessCodeList）
#### 场景描述
查询指定租间的接入码（接入码：即您面向客户提供的客服热线）
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/accessCodeInfo/queryAccessCodeList，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | X-APP-Key     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                                 |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号  | 名称          | 参数类型    | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|:---|
| 1.1 | accessCode  | string  | False | 接入码 支持模糊查询                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.2 | mediatypeId | integer | False | 媒体类型 - 2：点击通话  - 5：音视频  - 53：多媒体 升级到25.300.0版本及之后版本的环境中存在之前版本创建的租间时有此媒体类型。   - 49：多媒体（新） 25.300.0版本及之后版本的环境新建的租间有此媒体类型。    |
| 1.3 | description | string  | False | 接入码描述 支持模糊查询                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.4 | limit       | integer | False | 表示每页的查询数量，0-100，默认100，如果输入超过100，将默认查询100条                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.5 | offset      | integer | False | offset用于确定查询的起始页。offset取值范围为：offset=limit\*(page-1)，page为需要查询的起始页。offset默认值0，最大值100                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号      | 名称              | 参数类型            | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
  |:---|:---|:---|:---|:---|
  | 1.1     | data            | object          | False | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  | 1.1.1   | total           | number          | False | 数据总量                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  | 1.1.2   | calledRouteList | array\[object\] | False | 接入码信息列表                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | 1.1.2.1 | id              | string          | False | 接入码ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 1.1.2.2 | accessCode      | string          | False | 接入码                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | 1.1.2.3 | mediatypeId     | integer         | False | 媒体类型： 2：语音点击通话 5：音视频 18：视频点击通话 19：视频 53：多媒体 49：多媒体（新） |
  | 1.1.2.4 | n400Number      | string          | False | 接入码页面配置的服务号码，通常为核心网映射的400号码                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | 1.1.2.5 | description     | string          | False | 接入码描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 1.1.2.6 | numCallAttr     | number          | False | 号码属性（3：呼入和呼出；2：呼出；1：呼入）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | 1.2     | returnCode      | string          | False | 返回码 0：成功 其他：失败                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.3     | description     | string          | False | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
     
  
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 403**
  鉴权失败
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type:application/json
Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX
X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX
```
请求参数:
```
{
   "accessCode": "9911411",
   "mediatypeId": 5,
   "description": "接入码",
   "limit":10,
    "offset":0
}
```
响应参数:
```
{
    "returnCode": "0",
    "data": {
        "total": 1,
        "calledRouteList": [
            {
                "id": "1124167935465633793",
                "accessCode": "9911411",
                "mediatypeId": 5,
                "n400Number": null,
                "description": null,
                "numCallAttr": 3
            }
        ]
    },
    "description": "success"
}
```