# 概述
智能助手平台(OIAP)提供接口给包括IVR，聊天APP，CSP或客服云系统等调用，满足智能化交互场景的操作。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
所有URL中的IP：PORT均为OIAP在NSLB上对应的IP和PORT。
#### 典型交互序列
- 第一步 获取token 首先确认是系统粒度（内部系统如客服云或CSP）对接还是租户粒度（第三方系统）对接。
  第三方系统在与智能助手平台系统对接,需要使用租户id来获取token（[C3 智能助手平台接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0004.html#ZH-CN_TOPIC_0000002513073307)）,在token有效期内完成调用操作，而且后续每一次接口调用都需要传入获取的token。
  内部系统（客服云或CSP）与OIAP对接，需要使用默认系统对接约定的默认用户来获取token（[C3 智能助手平台接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0004.html#ZH-CN_TOPIC_0000002513073307)），在token有效期内完成调用操作，而且后续每一次接口调用都需要传入获取的token。
  
- 第二步 建立与智能助手平台系统的绑定关系
- 在获取token后，第三方需通过传入特定租户和语言信息查询号航系统对应已激活的领域（[领域查询接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0848.html#ZH-CN_TOPIC_0000002481273910)），并绑定第三方的接入标识与领域的绑定（[对话标识绑定查询接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0850.html#ZH-CN_TOPIC_0000002513233795)）。
- 第三步 完成对话交互 在将接入标识与智能助手平台系统的领域完成绑定后，就可以通过调用智能助手平台的各种对话接口来实现对话交互了（[对话接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0855.html#ZH-CN_TOPIC_0000002481113948)），比如初始化，放音，转接，挂机等。
  
 
#### 常用错误码
表1常用错误码参考表 
| 错误码       | 描述                       |
|:---|:---|
| 900001    | 无Token信息,或Token已过期。      |
| 900002    | 检查Token信息失败。             |
| 10000001  | 内部错误，通常因为应用系统故障引起。       |
| 10000002  | 参数错误。通常由于请求中未提供全部必填字段的值。 |
| 10000006  | 接口入参重复                   |
| 10000007  | 接口出参重复                   |
| 10000008  | 接口头参数重复                  |
| 10000003  | 参数不存在,必须输入该参数            |
| 10000004  | 参数已经在系统中存在,不能重复使用        |
| 20000001  | 处于发布状态不能修改               |
| 20000002  | 流程名已经存在                  |
| 20000003  | 删除节点错误,节点被别的流程引用         |
| 20000004  | 删除变量错误,变量被流程或者模板引用       |
| 20000005  | 修改变量错误,原变量被流程或者模板引用      |
| 20000006  | 文件路径不存在                  |
| 20000007  | IOException 读取文件流错误      |
| 20000008  | 更新数据错误                   |
| 200900002 | 内部错误,通常因为应用系统故障引起        |
| 200900003 | 参数错误。通常由于请求中未提供全部必填字段的值  |
| 200800001 | 密钥不存在                    |
| 200800002 | 密钥错误                     |
| 200800003 | 锁账号                      |