获取机器人列表

最近更新时间:2019-08-30 11:35:06

功能描述

获取指定 sdkappid(业务 ID)创建的全部机器人信息。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet/query_bot_list?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

URL 详细字段说明请参阅 URL 字段说明 文档。

请参数

字段名称 描述 类型 必填
auth 第三方帐号认证信息,用作回调验证第三方帐号合法性。 String
page_size 每页展示数量 String
page_index 请求索引,从 0 开始 String

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String
total_page 总页数 String
count 数量 String
botid 机器人唯一标识 String
nickname 机器人名称 String
qanum 知识库条数 String
createtime 创建时间戳 String

示例

请求示例

https://yun.tim.qq.com/v3/prophet/query_bot_list?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

{
    "auth": "", 
    "page_size": 10,
    "page_index": 0
}

响应示例

{
    "ActionStatus": "ok", 
    "ErrorCode": 0, 
    "ErrorInfo": "",
    "total_page": 10,
    "bot_total_num": 10,
    "bot_list":
    [
      {
        "botid": "bot_identifier1", 
         "nickname": "小二", 
         "qanum": "", 
         "createtime": 1499000000
       },
      {
          "botid": "bot_identifier2", 
          "nickname": "小二", 
          "qanum": "", 
            "createtime": 1499000000
      }
    ]
}