Skip to content

上报设备数据

设备主动上报数据,比如数据采集器上报传感器数据。该接口主要用于第三方数据上报。

https://agri-dl.holdingbyte.com/api/device/{{device_id}}data/?token={token}

请求方法

POST

携带数据

字段类型说明
agri_idstring内部id
tintutc时间戳(秒)
value1*数据1
value2*数据2

value1value2字段为自定义字段。不同设备可根据需要设定一个或多个字段数据。

数据示例:

json
[
    {
        "agri_id":"d-1000-yczqcwxdjptw-20-00",
        "value":1.0
    },
    {
        "agri_id":"d-1000-yczqcwxdjptw-20-01",
        "value":1,
        "back_up":true
    }
]

返回数据

返回已成功提交的数据。

示例代码

python
import requests
import json

# 设备id
device_id = "861714053848887"
# 请求token
token = "hvduasqoqnbtscaiumzsgpjewxkrgupq"

url = f"https://agri-rd-git-dev-yanjitech.vercel.app/api/device/{device_id}/data/"

payload = json.dumps([
  {
    "agri_id": "d-1000-yczqcwxdjptw-1-00",
    "value": 1.5
  }
])
headers = {
  'token': token,
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)