项目管理

不同项目之间的用户和设备数据均隔离，但相同用户可授权给多个项目。

创建项目

1. 注册并登录Aqara开发者平台；
2. 在右上角进入控制台，单击左侧导航栏的“项目管理”；
3. 单击右上角“新建项目”;
4. 按要求填写“项目名称”、“行业类型”、“项目简介”等信息；
5. 单击“保存”，提交审核；
6. 页面跳转项目列表，可查看刚创建项目的基本信息，包含AppId，且当前“审核状态”为“待审核”；
7. 审核通过后，“审核状态”改为“审核通过”，可查看项目详情。

编辑项目

1. 在“项目管理”页面，可查看当前开发者账号下的项目列表；
2. 单击任意已审核项目后的“详情”操作，可查看项目详情；
3. 单击“编辑”，即可更改项目信息。

管理项目

在项目详情页，包含“授权管理”、“消息推送设置”、“密钥管理”、“IP设置”、“设备调试”等功能。开发者可根据实际需求进行相关配置。

密钥管理

当项目审核通过后，会生成一个默认密钥和appkey，可在“项目详情”-“密钥管理”页面查看。开发者也可单击右上角的“添加”，新增密钥。

授权管理

只有获得账号的授权许可，才能访问与控制该账号下的设备。目前开发者平台支持三种类型的授权：Aqara账号、虚拟账号和项目授权。

1. 详细授权流程和接口，请参见授权管理。
2. 授权成功后，在“项目详情”-“授权管理”页面，选择授权的“服务区域”和“授权类型”；
3. 查看已授权用户列表，同时支持“跳转管理平台”和“设备调试”功能的操作。
   • “跳转管理平台”：根据授权类型跳转到不同的管理平台，可批量管控设备、查看设备轨迹、拓扑图等进行运营分析，快速定位设备问题。
   • “设备调试”：可跳转到设备调试页面，查看设备列表，并进行在线调试。

消息推送设置

通过消息推送功能，可将设备数据推送到第三方服务器，用于二次开发。具体操作可参见消息推送说明。

IP设置

默认情况下，IP设置是为空的，即无IP限制均可访问接口。若考虑安全性问题，可配置IP白名单，即仅添加的IP可访问当前项目接口。

1. 在“项目详情”-“IP设置”页面，单击右上角的“添加”；
2. 按实际情况填写"网络出口IP"、"服务区域"、"状态"等信息；
3. 单击“保存”，即可在列表页面查看基础配置信息。

设备调试

开发者平台支持对真实设备和虚拟设备进行在线设备调试。

创建设备

• 真实设备

  可通过“授权管理”页面进行跳转，可对已授权账号下的设备进行在线调试。

• 虚拟设备

  在“设备调试”页面，单击右上角“添加”，选择“openId”、“虚拟设备模型值”、“虚拟网关设备”，单击保存，完成创建。注意：需先添加网关设备，再添加子设备。

调试设备

在“设备调试”页面，需调试设备的操作拦中单击“调试”，在“资源控制”页面选择“资源”、“方法”和“描述”，填写对应JSON请求，单击“发送”即可发送指令。在“实时日志”中，可查看调用结果。

删除设备

仅虚拟设备可在“设备调试”页面进行删除，单击操作拦的“删除”即可。

真实设备需通过接口或者重置设备删除。