需通过api与龙虾机器人交互：一、用bearer token认证并设json头；二、get /v1/robot/status查状态；三、post /v1/robot/control发运动指令；四、get /v1/robot/sensor/stream订阅传感器流；五、依错误码处理异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望与龙虾机器人进行交互，需要通过其提供的API接口发送标准化请求并解析返回数据。以下是该API的结构说明与典型调用方式：
一、基础认证与请求头配置
所有API请求必须携带有效的身份凭证，以确保访问权限受控。认证采用Bearer Token机制，Token需在请求头中显式声明。
1、登录龙虾机器人管理后台，进入“开发者设置”页面获取API Key。
2、使用该API Key生成JWT格式的Bearer Token，有效期为24小时。
3、在HTTP请求头中添加字段：Authorization: Bearer
4、统一设置Content-Type: application/json，确保请求体为合法JSON格式。
二、获取机器人状态接口
该接口用于实时查询龙虾机器人的在线状态、电量、运动模块健康度等基础运行参数，适用于监控场景。
1、向GET /v1/robot/status发起请求。
2、响应体中"online"字段为true表示设备已连接云端。
3、检查"battery_level"数值，若低于15%，建议触发充电指令。
4、解析"motor_health"数组，任一子项含"error"标识即表示对应关节异常。
三、下发运动控制指令
通过该接口可驱动龙虾机器人执行前进、转向、夹取等物理动作，指令以异步方式提交至设备队列。
1、构造POST请求至/v1/robot/control。
2、请求体示例：{"action": "move_forward", "distance_cm": 30, "speed": 0.4}。
3、支持的动作类型包括：move_forward、rotate_degree、grip_open、grip_close。
4、响应中返回task_id，可用于后续轮询执行结果。
四、订阅传感器实时数据流
该功能通过Server-Sent Events（SSE）建立长连接，持续接收摄像头图像元数据、红外距离值及陀螺仪原始读数。
1、向GET /v1/robot/sensor/stream发起SSE连接请求。
2、连接建立后，每秒收到一条JSON格式事件，含"sensor_type"与"value"字段。
3、当接收到event: disconnect时，应主动重连并携带上一次的last_event_id。
4、图像类数据不直接传输像素，仅返回base64编码的缩略图哈希值及时间戳。
五、错误码与异常响应处理
接口返回非2xx状态码时，响应体固定包含code、message、trace_id三项，用于快速定位问题根因。
1、401 Unauthorized：Token过期或签名无效，需重新生成并刷新请求头。
2、403 Forbidden：当前API Key未授权访问该资源路径，检查权限策略配置。
3、429 Too Many Requests：单位时间内调用超限，需按Retry-After响应头指定秒数延迟重试。
4、503 Service Unavailable：机器人离线或固件版本不兼容，应调用状态接口确认设备在线性。
