
# 单个创建接入码与技能队列、IVR绑定关系（createCalledRoute）
#### 场景描述
单个创建接入码与技能队列、IVR绑定关系的接口
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/calledRoute/createCalledRoute，例如域名是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  | True  | 接入码；最大长度32字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.2 | extCode     | string  | False | 扩展码； 最大长度12字符（如果希望一个接入码能设置多个目的设备。这种情况下可通过配置扩展码的方式来实现，例如，接入码为12345，我们可以添加扩展码1，路由到技能队列A，扩展码2，路由到技能队列B。这样客户可直接拨打123451实现直接接入技能队列A。）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.3 | mediaTypeId | integer | False | 媒体类型；默认值：5 字段可选值：（2：语音点击通话 5：音视频 18：视频点击通话 19：视频 53：多媒体） 说明： 1、传入技能队列（devicetype=1）时，mediaTypeId等于传入的技能队列绑定的mediaTypeId（没有绑定默认5） 2、接入码accessCode所属的媒体类型（查询接入码接口返回的mediaTypeId字段）和该入参mediaTypeId的对应关系如下： 5对应5和19； 53对应53； 2对应2和18 |
| 1.4 | devicetype  | integer | True  | 设备类型； 1：技能队列 3：IVR 说明：多媒体渠道不能选择IVR流程                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.5 | deviceId    | integer | True  | 目标设备id（技能队列skillId、IVR的id） 说明：传入技能队列（devicetype=1）时，deviceId的对应的媒体类型要和入参mediaTypeId一致                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号  | 名称          | 参数类型   | 是否必选  | 说明             |
  |:---|:---|:---|:---|:---|
  | 1.1 | returnCode  | string | False | 返回码 0：成功 其他：失败 |
  | 1.2 | description | string | False | 描述             |
     
  
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 403**
  鉴权失败
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type:application/json
Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX
X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX
```
请求参数:
```
{
    "accessCode": "9911411", 
    "extCode": "11",
    "devicetype": 1, 
    "deviceId": 1,
    "mediaTypeId": 19
}
```
响应参数:
```
{
    "returnCode": "0",
    "description": "data create success"
}
```
