Skip to content

快速开始 ​

完成第一次调用需要一个已启用的 OpenAPI 客户端、对应的 AK/SK,以及至少一项已发布的能力授权。

接入流程 ​

  1. 由 UVP 管理员创建客户端并安全交付一次性 SK。
  2. 为客户端设置归属部门、数据范围、调用速率和观看配额。
  3. 授权 device:list,并确认该能力已发布。
  4. 在服务端生成时间戳、Nonce 和 HMAC 签名。
  5. 请求 GET /openapi/v1/devices。

最小请求 ​

http
GET /openapi/v1/devices?page=1&pageSize=20 HTTP/1.1
Host: uvp.example.com
X-UVP-Sign-Version: 1
X-UVP-Access-Key: <AK>
X-UVP-Timestamp: <Unix 秒>
X-UVP-Nonce: <32 位小写十六进制>
X-UVP-Signature: <64 位小写十六进制>

成功时返回统一响应结构,业务结果位于 data。

json
{
  "code": "OK",
  "message": "success",
  "data": {
    "items": [],
    "page": 1,
    "pageSize": 20,
    "total": 0
  }
}

下一步 ​