获取机器人列表

获取机器人list

请求地址

https://{baseURL}/api/v1/aicall/robot/query?appkey=[appkey]&nonce=[nonce]&timestamp=[timestamp]&signature=[signature]

请求方式:

POST

请求参数:

属性 类型 约束 描述 举例说明
page_no integer 必填 查询的页数 1
page_size integer 必填 每页查询的条数 10

请求示例

POST /api/v1/aicall/robot/query?appkey=[appkey]&nonce=[nonce]&timestamp=[timestamp]&signature=[signature]
Accept:application/json;
{
    "page_no": 1,
    "page_size": 10
}

响应包体:

属性 类型 说明
code integer 请求状态码,此时为0
msg string 请求状态码描述,此时为空
data object 结果集
data.total_count integer 机器人数量
data.total_page integer 总页数
data.cur_page integer 当前页数
data.page_size integer 每页数量
data.list Array
data.list.robot_id String 机器人ID
data.list.desc String 机器人描述
data.list.name String 机器人名称
data.list.image String 机器人头像
data.list.kind integer 机器人类型: 1-外呼 2-呼入
data.list.status integer 机器人状态:1-未上线(审核拒绝) 2-审核中 3-在线(审核通过) 4-暂停使用 5-已过期

响应示例:

{
    "code": 0,
    "msg": "success",
    "data": {
        "total_count": 2,
        "total_page": 1,
        "cur_page": 1,
        "page_size": 10,
        "list": [
            {
                "robot_id": "BOToldkch6mxolwv",
                "desc": "",
                "name": "测试",
                "image": "",
                "kind": 1,
                "status": 5
            },
            {
                "robot_id": "BOThtzjfhvwm9y2w",
                "desc": "",
                "name": "机器人0401",
                "image": "",
                "kind": 1,
                "status": 5
            }
        ]
    }
}
文档更新时间: 2025-05-29 11:40   作者:admin