查询四足机器人列表
分页查询平台中的四足机器人及其基础信息。
接口基础信息
Section titled “接口基础信息”- 接口名称: 查询四足狗列表
- 接口说明: 查询四足狗列表
- 请求方式:
POST - 请求路径:
remoteApi/dogPage - 是否需要登录: 否
- 是否需要权限: 是
| 参数名 | 类型 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| dogName | String | 否 | 狗名称 | |
| deviceMode | String | 否 | 设备型号 | |
| pageNum | Integer | 否 | 页码 | |
| pageSize | Integer | 否 | 分页大小 |
样例:
{ "pageNum": 1, "pageSize": 15, "dogName": "测试", "deviceMode": "X30"}实际入参样例(其他http对外接口 同理)
在原始业务入参中补充签名参数 timestamp、nonce、sign 和 appKey。secretKey 参与签名生成,实际请求中可不传。
{ "pageNum": 1, "pageSize": 15, "dogName": "测试", "deviceMode": "X30", "secretKey": "kQwIOrYvnXmSDkwEiFngrKidMcdrgKor", "timestamp": "1770601227007", "nonce": "HypPCn0tMJW549OMPNu32A3fyLSbsQ3w", "sign": "55DC7607104A2D7BD411BCA8000C4B45", "appKey": "123"}| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| dogName | String | X30-1 | 四足狗名称 |
| dogCode | String | 1 | 四足狗编号(唯一编码) |
| deviceMode | String | X30 | 设备型号 |
| dogTypeCode | String | 机器狗型号编码 | |
| productionCode | String | 1 | 出厂编号 |
| ip | String | 192.168.1.106 | 四足狗访问 IP |
| port | String | 10099 | 四足狗服务端口 |
| floor | String | a001 | 区域编码(多个用逗号分隔) |
样例:
{ "success": true, "code": 200, "msg": "操作成功", "data": { "records": [ { "dogName": "测试2", "dogCode": "DOG2011698164458029056", "deviceMode": "X30", "dogTypeCode": null, "productionCode": "DOG2011698164458029056", "ip": "1.1.1.1", "port": "10099", "floor": null } ], "total": 1, "size": 15, "current": 1, "pages": 1 }}| 错误码 | 描述 |
|---|---|
| 400 | 参数错误 |
| 401 | 未授权 |
| 403 | 没有访问权限 |
| 404 | 找不到资源 |
| 500 | 服务器内部错误 |