{
"lat": 40.4168,
"lon": -3.7038,
"timezone": "Europe/Madrid",
"date": "2026-06-21",
"sunrise": "2026-06-21T06:45:59+02:00",
"sunset": "2026-06-21T21:49:38+02:00",
"solarNoon": "2026-06-21T14:17:48+02:00",
"nadir": "2026-06-21T02:17:48+02:00",
"dayLength": "15h 3m 39s",
"dayLengthSeconds": 54219,
"civilTwilight": {
"dawn": "2026-06-21T06:12:47+02:00",
"dusk": "2026-06-21T22:22:49+02:00"
},
"nauticalTwilight": {
"dawn": "2026-06-21T05:30:30+02:00",
"dusk": "2026-06-21T23:05:06+02:00"
},
"astronomicalTwilight": {
"dawn": "2026-06-21T04:40:48+02:00",
"dusk": "2026-06-21T23:54:49+02:00"
},
"goldenHour": {
"morningEnds": "2026-06-21T07:27:04+02:00",
"eveningStarts": "2026-06-21T21:08:32+02:00"
},
"sunAltitudeAtNoonDeg": 73.02
}
curl --location --request GET 'https://zylalabs.com/api/14209/sunrise+sunset+and+moon+phase+api/35275/sun+times?lat=40.4168&lon=-3.7038&date=2026-06-21&tz=auto' --header 'Authorization: Bearer YOUR_API_KEY'
{
"lat": 40.4168,
"lon": -3.7038,
"timezone": "Europe/Madrid",
"at": "2026-06-21T14:14:48+02:00",
"phase": "First Quarter",
"emoji": "🌓",
"phaseValue": 0.2349,
"illuminationPercent": 45.3,
"ageDays": 6.9,
"waxing": true,
"moonrise": "2026-06-21T13:48:26+02:00",
"moonset": null,
"alwaysUp": false,
"alwaysDown": false,
"position": {
"altitudeDeg": 4.77,
"azimuthDeg": 92.44,
"distanceKm": 384071
},
"nextNewMoon": "2026-07-14T09:18:30+02:00",
"nextFullMoon": "2026-06-30T01:37:23+02:00"
}
curl --location --request GET 'https://zylalabs.com/api/14209/sunrise+sunset+and+moon+phase+api/35276/moon+phase+and+times?lat=40.4168&lon=-3.7038&date=2026-06-21&tz=auto' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 日出 日落 和月相 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
“获取太阳时间”端点返回日出、日落、太阳中午、白天长度、黄昏阶段、黄金时段和月亮信息,包括相位和月出/月落时间的数据 “获取月相和时间”端点提供月相细节、照明、月出/月落时间以及下一个新月和满月日期
关键字段包括纬度(lat)、经度(lon)、时区、日期、日出、日落、太阳正午、白昼长度、黄昏时间、黄金时刻、月相、照明百分比、月出和月落时间。每个字段提供与太阳和月亮的位置及相位相关的特定信息。
用户可以为他们的请求指定坐标(纬度和经度)以及日期。这使得根据特定位置和时间定制返回的数据成为可能,从而为任何所需的地理区域和日期提供量身定制的结果
响应数据采用 JSON 格式结构,嵌套对象用于黄昏和金色时刻。每个键值对提供特定信息,使得程序化解析和利用数据变得简单,适用于天文学或摄影等应用
该API根据已建立的太阳和月亮位置算法进行天文计算来获取数据。这确保了日出、日落、月相和其他相关现象的时机高度准确
典型用例包括规划户外活动 摄影 园艺和天文观察 用户可以利用数据根据阳光和月光的可用性来优化事件的时间
用户可以通过将返回的数据集成到应用程序中,利用这些数据来安排事件,为特定的太阳或月亮相位创建提醒,或根据提供的时间和相位生成太阳和月球周期的可视化
如果结果是部分的或为空,用户应该检查输入参数的准确性,例如有效的坐标和日期。在应用程序中实施错误处理可以帮助优雅地管理这些情况,确保顺畅的用户体验