List Quadruped Robots
List quadruped robots and their basic information with pagination.
Endpoint Information
Section titled “Endpoint Information”- Name: List quadruped robots
- Description: Returns a paginated list of quadruped robots.
- Method:
POST - Path:
remoteApi/dogPage - Login required: No
- Permission required: Yes
Request Parameters
Section titled “Request Parameters”| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| dogName | String | No | Robot name | |
| deviceMode | String | No | Device model | |
| pageNum | Integer | No | Page number | |
| pageSize | Integer | No | Page size |
Example:
{ "pageNum": 1, "pageSize": 15, "dogName": "Test", "deviceMode": "X30"}Complete request example (the same rule applies to the other public HTTP endpoints):
Add the signature parameters timestamp, nonce, sign, and appKey to the business parameters. secretKey
participates in signature generation and may be omitted from the actual request.
{ "pageNum": 1, "pageSize": 15, "dogName": "Test", "deviceMode": "X30", "secretKey": "kQwIOrYvnXmSDkwEiFngrKidMcdrgKor", "timestamp": "1770601227007", "nonce": "HypPCn0tMJW549OMPNu32A3fyLSbsQ3w", "sign": "55DC7607104A2D7BD411BCA8000C4B45", "appKey": "123"}Response
Section titled “Response”| Field | Type | Example | Description |
|---|---|---|---|
| dogName | String | X30-1 | Quadruped robot name |
| dogCode | String | 1 | Unique quadruped robot code |
| deviceMode | String | X30 | Device model |
| dogTypeCode | String | Robot model code | |
| productionCode | String | 1 | Serial number |
| ip | String | 192.168.1.106 | Robot IP address |
| port | String | 10099 | Robot service port |
| floor | String | a001 | Area codes, separated by commas when multiple values are present |
Example:
{ "success": true, "code": 200, "msg": "Operation succeeded", "data": { "records": [ { "dogName": "Test 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 }}Error Codes
Section titled “Error Codes”| Code | Description |
|---|---|
| 400 | Invalid parameters |
| 401 | Unauthorized |
| 403 | Access denied |
| 404 | Resource not found |
| 500 | Internal server error |