月亮

访问限制

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

提供月升时间、月落时间、月相以及逐小时高度角和方位角数据。

月升月落

• 错误信息

请求

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

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	否	0.0	—	经度
latitude	否	0.0	—	纬度
lang	否	zh-Hans	—	语言，详见 多语言支持
days	否	3	1~15	返回天数

请求示例

curl "https://singer.caiyunhub.com/v3/astro/moon?longitude=116&latitude=39&lang=zh-Hans&days=15&token={token}"

响应示例

{
  "moon": [
    {
      "date": "2022-05-20",
      "rise": "22:48",
      "set": "10:09",
      "phase": 233.22,
      "phase_name": "亏凸月"
    },
    {
      "date": "2022-05-21",
      "rise": "23:45",
      "set": "11:08",
      "phase": 246.7,
      "phase_name": "亏凸月"
    },
    {
      "date": "2022-05-22",
      "rise": "-",
      "set": "12:03",
      "phase": 259.84,
      "phase_name": "下弦月"
    }
  ]
}

响应字段

JSONPath	类型	说明
$.moon	array	月升月落及月相数据
$.moon[].date	string	日期
$.moon[].rise	string	升起时间，如果没有升起则是 -
$.moon[].set	string	落下时间，如果没有落下则是 -
$.moon[].phase	number	月相角度
$.moon[].phase_name	string	月相名称

简体中文环境下支持的月相可能取值：

Emoji	月相
🌑	新月
🌒	眉月
🌓	上弦月
🌔	盈凸月
🌕	满月
🌖	亏凸月
🌗	下弦月
🌘	残月

月亮高度/方位角

提供逐小时的月亮高度角和方位角数据。

• 错误信息

请求

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

查询参数

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

请求示例

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

响应示例

{
  "data": [
    { "timestamp": 1769468400, "altitude": 21.5018, "azimuth": 268.0806 },
    { "timestamp": 1769472000, "altitude": 18.6872, "azimuth": 282.1501 },
    // ...
    { "timestamp": 1769637600, "altitude": 35.81, "azimuth": 225.1094 }
  ]
}

响应字段

JSONPath	类型	说明
$.data	array	逐小时月亮位置数据
$.data[].timestamp	number	时间戳
$.data[].altitude	number	高度角
$.data[].azimuth	number	方位角