使用访问令牌请求开放接口

本文将介绍如何创建和使用访问令牌来调用开放接口读取设备数据。

创建访问令牌

1. 登录设备管理系统
2. 进入组织详情页，在"访问令牌"卡片中，点击"创建令牌"按钮

3. 填写令牌信息：
   • 令牌名称：用于标识令牌用途
   • 过期时间：可选，不设置则永不过期
4. 点击"确定"创建令牌

使用访问令牌

所有 API 请求都需要在 HTTP 头部包含访问令牌：

Authorization: Bearer your_access_token

API 示例

获取设备列表：

Python 示例：

import requests

def get_device_data(device_id, access_token):
    url = f"https://ums.holdingbyte.com/api/v2/devices/{device_id}/data/"
    headers = {
        "Authorization": f"Bearer {access_token}"
    }
    response = requests.get(url, headers=headers)
    return response.json()

get_device_data("your_device_id", "your_access_token")

Php 示例：

function getDeviceData($deviceId, $accessToken) {
    $url = "https://ums.holdingbyte.com/api/v2/devices/{$deviceId}/data/";
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer {$accessToken}"
    ]);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

响应示例：

{
    "success": true,
    "data": [
        {
            "agri_id": "因子ID",
            "value": 23.5,
            "t": 0
        },
        {
            "agri_id": "因子ID",
            "value": 45.2,
            "t": 0
        }
    ],
    "error": null
}