快速开始
完成第一次调用需要一个已启用的 OpenAPI 客户端、对应的 AK/SK,以及至少一项已发布的能力授权。
接入流程
- 由 UVP 管理员创建客户端并安全交付一次性 SK。
- 为客户端设置归属部门、数据范围、调用速率和观看配额。
- 授权
device:list,并确认该能力已发布。 - 在服务端生成时间戳、Nonce 和 HMAC 签名。
- 请求
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
}
}