土壤温湿度

目前仅支持中国区域实况数据，逐小时更新

Request

http

GET https://api.caiyunapp.com/v1/soil

Query Parameters

Name	Required	Default	Range	Description
`token`	Yes	—	—	API token; see Authentication
`lng`	Yes	—	—	Longitude
`lat`	Yes	—	—	Latitude

Request Example

bash

curl "https://api.caiyunapp.com/v1/soil?token={token}&lng=116&lat=39"

Response Example

json

{
  "status": "ok",
  "result": {
    "soil": [
      {
        "depth": "0-0.1",
        "tsoil": 3.100006103515625,
        "soliw": 0.1529541015625
      },
      {
        "depth": "0.1-0.4",
        "tsoil": 4.850006103515625,
        "soliw": 0.237060546875
      }
    ],
    "meta": {
      "updated_at": 1640248183, // 数据更新时间
      "datatime": 1640246400 // 数据批次时间
    }
  }
}

Response Fields

JSONPath	Type	Description
`$.status`	string	Request status
`$.result.soil`	`array<object>`	Soil layers
`$.result.soil[].depth`	string	Soil depth range
`$.result.soil[].tsoil`	number	Soil temperature
`$.result.soil[].soliw`	number	Soil moisture
`$.result.meta.updated_at`	number	Data update timestamp
`$.result.meta.datatime`	number	Data batch timestamp