快速开始

三步接入 PeIoT Sense，让 AI 感知真实世界

1 获取 API Key

登录 PeIoT 平台后台，进入「AI API Key」管理页面，点击「新建」生成一组 API Key。 Key 格式为 pk_live_ 前缀 + 32位随机字符串。

你的 API Key 
# 示例 API Key（请替换为你自己的）
X-API-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2 测试连接

使用 Ping 接口验证 API 服务是否正常运行（无需认证）：

健康检查 
curl https://peiot.net/api/ai/v1/Ping/index

# 响应：
{
  "code": 0,
  "msg": "pong",
  "data": { "version": "1.0.0", "service": "PeIoT Sense AI API" }
}

3 获取设备数据

携带 API Key 请求设备列表，获取你的设备 passkey，然后查询实时数据：

获取设备列表 
curl -H "X-API-Key: pk_live_xxx" \
     https://peiot.net/api/ai/v1/Devices/index
获取实时数据 
curl -H "X-API-Key: pk_live_xxx" \
     https://peiot.net/api/ai/v1/Devices/realtime?passkey=5ae9e91d...

# 响应包含 summary 字段，AI 可直接引用：
"summary": "温度23.5°C，湿度65.2%，气压1013.25hPa。环境舒适。"

接下来