标识符说明

平台使用以下四个核心标识符定位资源。它们用途不同，不能混用。

组织标识（org.slug）

组织的 URL 标识符，小写唯一。创建组织时自动生成，可在组织设置中修改。

使用位置：

• 开放 API 请求头：X-Organization-Slug: your-org-slug
• 决定请求在哪个组织范围内执行

项目 ID（project.project_id）

项目的唯一标识符，由平台自动生成，格式为 proj_ 加 10 位随机字母。

使用位置：

• 开放 API 路径：/api/v2/projects/{project_id}/...
• 在项目设置页可复制

设备标识（device.agri_id）

设备在平台内部的唯一标识符，由平台自动生成，格式为 d-1000-{12位小写字母}。

与设备序列号的区别：

• 序列号（serial_number）：设备出厂时自带的硬件标识（如 IMEI、MAC），用于绑定设备到组织。
• agri_id：设备接入平台后生成的内部标识，用于 API 调用和数据路由。

绑定完成后，后续操作均使用 agri_id。

点位标识（point.agri_id）

点位在平台内部的唯一标识符，由平台根据设备与点位配置自动生成。

使用位置：

• 数据转发中的点位标识
• 实时数据查询
• 控制命令（开/关/正转/反转等）

点位标识应以平台页面或 API 返回为准，不要手动拼接。

使用对照

操作	应使用的标识
绑定设备	设备序列号（serial_number）
调用开放 API	组织标识（Header）、项目 ID / 设备标识（路径）
查询点位数据 / 下发控制	点位标识（point.agri_id）
数据转发配置	点位标识（point.agri_id）

更多字段说明请参考 开放 API V2。