机器人话术列表
服务描述
本接口,可用于获取机器人话术,支持按机器人名称查询。
开发须知
调用本接口前,请先获取appId
服务地址
GET/POST https://{您的专属域名}/outbound/openapi/v2/robot
请求参数
参数 | 位置 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
appId | header | String | Y | 应用ID |
timestamp | header | String | Y | 时间戳,毫秒 |
sign | header | String | Y | 签名 |
encrypted | header | String | N | 是否需要加密,需要加密传值(加密方式):AES/REQBODY/RESP,不需要加密不用传该字段 |
Content-Type | header | String | Y | application/json |
robotName | url地址栏 | String(32) | N | url请求参数,url?robotName={机器人名称} |
post请求
robotName
不需要加密POST https://{您的专属域名}/outbound/openapi/v2/robot?robotName={机器人名称}
数据示例:
GET https://{您的专属域名}/outbound/openapi/v2/robot?robotName={机器人名称}
返回结果加密
加密方式
header
中的encrypted
传值,表示需要对返回结果进行加密,拿到加密后的返回结果, 使用私钥加解密工具进行解密
返回结果
- 需要加密,以下是返回结果加密前的json
- 不需要加密则直接直接返回不加密的结果
参数 | 类型 | 说明 |
---|---|---|
code | String | 结果码 |
message | String | 结果描述 |
data | JSONArray | 机器人话术列表 |
JSONObject
参数 | 类型 | 说明 |
---|---|---|
label | String(32) | 机器人名称 |
value | String(32) | 机器人id |
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": [
{
"label": "xb测试机器人",
"value": "f81f6c149c0b459caea67c4c58b81bb3"
},
{
"label": "zp测试机器人",
"value": "2f50535d41a44ec0afe9727a7a43a770"
},
{
"label": "测试机器人",
"value": "72dfc84f81b4488b9718d50281e9982c"
}
]
}
结果码说明
结果码 | 说明 |
---|---|
10000 | 请求成功 |
20001 | 请求失败 |
21002 | 认证失败,请重新登录 |
FAQ:
*