太阳

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

提供日出日落时间以及逐小时高度角和方位角数据。

日出日落

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/astro/sun

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	否	0.0	—	经度
latitude	否	0.0	—	纬度
dailystart	否	0	-1、0	起始天数偏移，-1 表示从昨天开始
days	否	3	1~15	返回天数

请求示例

curl "https://singer.caiyunhub.com/v3/astro/sun?longitude=116&latitude=39&dailystart=-1&days=3&token={token}"

响应示例

{
  "data": [
    {
      "date": "2026-01-27",
      "rise": "07:21",
      "set": "17:26",
      "astronomical_dawn_start": "05:30",
      "astronomical_dusk_end": "19:17",
      "civil_dawn_start": "06:52",
      "civil_dusk_end": "17:55",
      "nautical_dawn_start": "06:12",
      "nautical_dusk_end": "18:35",
      "solar_midnight": "00:23",
      "solar_noon": "12:23"
    }
    // ...
  ]
}

响应字段

JSONPath	类型	说明
$.data[].date	string	日期
$.data[].rise	string	日出时间，如果没有则是 -
$.data[].set	string	日落时间，如果没有则是 -
$.data[].astronomical_dawn_start	string	天文曙光开始，如果没有则是 -
$.data[].astronomical_dusk_end	string	天文昏影结束，如果没有则是 -
$.data[].civil_dawn_start	string	民用曙光开始，如果没有则是 -
$.data[].civil_dusk_end	string	民用昏影结束，如果没有则是 -
$.data[].nautical_dawn_start	string	航海曙光开始，如果没有则是 -
$.data[].nautical_dusk_end	string	航海昏影结束，如果没有则是 -
$.data[].solar_midnight	string	太阳子夜，如果没有则是 -
$.data[].solar_noon	string	太阳正午，如果没有则是 -

太阳高度/方位角

提供逐小时的太阳高度角和方位角数据。

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/astro/sun/location/

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	否	0.0	—	经度
latitude	否	0.0	—	纬度
days	否	1	1~2	返回天数

请求示例

curl "https://singer.caiyunhub.com/v3/astro/sun/location/?longitude=116&latitude=39&days=2&token={token}"

响应示例

{
  "data": [
    { "timestamp": 1671638400, "altitude": -74.1515, "azimuth": 348.0473 },
    // ...
    { "timestamp": 1671721200, "altitude": -67.8016, "azimuth": 309.0398 }
  ]
}

响应字段

JSONPath	类型	说明
$.data[].timestamp	number	时间戳
$.data[].altitude	number	高度角
$.data[].azimuth	number	方位角