常见问题
本页汇总 V1/V2 接口对接过程中的常见问题。V3 接口的字段与调用约定,请优先查阅对应接口页面。
一、开发者与凭证
1. 如何成为开发者?
账号注册与凭证申请在 V1、V2、V3 之间完全一致,统一由 OpenAPI V3 快速开始 维护,本页不再重复步骤。完整流程包含三步:
- 邀请注册高仙开发者:组织内邀请,或由管理员在 IAM 客户中心代管理其他组织。
- 激活开发 者账号:按激活邮件完成激活;已有账号需要补充角色时,由用户管理员在 IAM 用户管理中编辑角色。
- 创建 AccessKey:在开发者中心「我的 AccessKey」创建,同时获得
AccessKeyID、AccessKeySecret、ClientID和ClientSecret。
应用管理已停止使用
原「应用管理」不再用于创建应用。新建 AccessKey 时系统会自动生成应用信息,无需再单独创建应用。
二、接口权限
2. 为什么获取机器人列表返回的机器人和账号绑定的不一致?
账号绑定的机器人属于个人账号与机器人的关系;通过接口获取的机器人属于客户与机器人的关系,两者不是同一套关系。
获取机 器人接口路径:/openapi/v1alpha1/RobotService_ListRobots
relation传值contract:获取合同客户下的机器人。relation传空:获取终端客户下的机器人。relation传值cugrup:获取集团下的机器人。适用于运维商服务的机器存在多个终端客户的场景,需提前联系高仙升级集团。
三、机器人控制
3. 控制机器前,为什么先获取机器人状态?
如果要向机器人发出指令,请先获取机器人的实时状态,再根据实时状态数据发出指令。例如,不能使用两小时前的机器人状态来发出指令;如果机器人本身已经移动或状态发生变化,可能存在安全风险。

4. 机器人任务下发,哪个接口?
按机型与软件版本区分:
- 非 S 机器且软件版本早于 AIO:
openapi/v1alpha1/robots/{robot}/commands/{command} - S 线机型且现场未部署站点,无站点任务启动 API:
- 接口路径:
/openapi/v2alpha1/robotCommand/tempTask:send areaID:1-255 任意传值,属于历史设计问题。
- 接口路径:
- S 线机器或已升级 AIO 版本的机器,站点任务下发:
openapi/v2alpha1/site/submitTask

5. 机器人状态返回值有哪些?
接口路径:openapi/v1alpha1/robots/{robot}/status
taskState 只有 4 个返回值:空闲、执行中、任务暂停、其他。暂无导航相关状态开放。
