• 文档
• API 鉴权

API 鉴权

EnOS API 身份验证采用服务账号 SA（Service Account）来验证应用或开发者的身份。在请求 EnOS API 请求时，应用开发人员需要将 SA 发送到 EnOS，通过它验证用户身份并执行所需的授权访问。

前提条件

确保你在 EnOS 应用门户的账号拥有 设备接入和管理人员 或 应用开发人员 角色，可以访问 开发者控制台。若无可联系 OU 管理员为账号分配角色。

步骤 1：获取服务账号

操作人：应用开发人员

SA 由应用的 AccessKey 和 SecretKey 组成，1 个应用对应 1 个 SA。你需要先获取应用的 SA，作为调用 EnOS API 的身份凭证。

1. 登录 EnOS 应用门户，选择右上角的 按钮，进入 开发者控制台，在左侧导航栏中选择 应用 > 应用注册。

2. 选择 1 个已有应用，或通过以下任意一种方式为当前 OU 添加新应用：

   • 注册应用：在当前 OU 内从头创建新应用。参见 注册应用。

   • 获取应用：从其它 OU 获取 1 个已有应用至当前 OU。参见 获取应用。

3. 在 组织应用 或 已获取 的标签页下，点击应用卡片，打开 应用详情 页面，查看应用的 AccessKey 和 SecretKey。

步骤 2：（可选）获取 API 调用权限

操作人：应用开发人员

备注

默认情况下，你可以调用 EnOS API，无需任何授权。仅当调用以下 API 前，你需要为应用获取 API 调用权限：

• 模型服务

• 接入服务

• 资产服务

• 资产树服务

若不需要调用这些 API，可跳过此步骤。

按照以下步骤为应用分配 API 调用权限：

1. 登录 EnOS 应用门户，选择右上角的 按钮，进入 开发者控制台，在左侧导航栏中选择 应用 > API 管理 > API 授权。

2. 选择 添加授权，进入添加授权页面，配置以下信息：

   • 授权应用名称：选择你的应用名称。

   • 授权方式：选择 手动配置，在下方 API 列表中勾选需要授权的 API。

结果

你可以使用应用 SA，参照 通过 EnOS SDK 调用 EnOS API 或 通过 Access Token 调用 EnOS API，获取或更新指定资源。