API Trăng Trở về
Tìm thời điểm tiếp theo Mặt Trăng trở về kinh độ sinh của nó vào hoặc sau một ngày được chọn - khoảng mỗi 27.3 ngày - và tạo biểu đồ cho nó tại một vị trí bạn chọn. Truyền dữ liệu sinh và ngày bắt đầu, nhận biểu đồ Trăng Trở về. Độ chính xác Swiss Ephemeris, JSON ra.
API Trăng Trở về
Điểm cuối Trăng Trở về đọc kinh độ chính xác của Mặt Trăng sinh từ dữ liệu sinh được cung cấp, sau đó tìm kiếm từ ngày bắt đầu đã cho để tìm thời điểm đầu tiên Mặt Trăng di chuyển trở lại cùng kinh độ đó. Vì Mặt Trăng hoàn thành một chu kỳ sideral trong khoảng 27.3 ngày, lần trở về đó xảy ra hàng tháng. Điểm cuối giải quyết thời điểm khớp thành một ngày Julian, lấy vị trí và tốc độ địa tâm từ động lực Swiss Ephemeris, và tạo một biểu đồ đầy đủ cho nó - các hành tinh trở về với vị trí cung và nhà, các đỉnh nhà, và lưới khía cạnh hoàn chỉnh với các cờ áp dụng và tách biệt và độ chính xác. Theo mặc định, biểu đồ được tạo cho nơi sinh, nhưng bạn có thể cung cấp vĩ độ và kinh độ vị trí khác để di chuyển lại lần trở về, điều đó định hình lại các góc và nhà trong khi giữ cùng thời điểm trở về. Kết quả đọc như bản đồ chủ đề cảm xúc và nhịp điệu cho tháng trăng tiếp theo.
POST/v1/lunar-return
curl -X POST https://api.astroway.info/v1/lunar-return \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"afterDate": "2026-06-15"
}' {
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Moon",
"longitude": 282.7,
"sign": "Capricorn",
"house": 6
}
],
"houses": {
"ascendant": 201.5,
"mc": 110.3,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| afterDate | string (YYYY-MM-DD) | yes | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | no | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | no | Optional UTC offset for the start point, in hours. |
| locationLat | number | no | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | no | Optional longitude in decimal degrees to relocate the return chart, east positive. |
When to use it
Sử dụng Trăng Trở về cho dự báo chu kỳ ngắn, khoảng hàng tháng - một tính năng 'tháng trăng trước', theo dõi nhịp điệu cảm xúc, hoặc người bạn đồng hành chi tiết hơn với Trăng Trở về hàng năm. Trong khi Trăng Trở về hàng năm khung cho cả một năm, Trăng Trở về khung cho bốn tuần tiếp theo, làm cho nó rất phù hợp với các báo cáo hàng tháng lặp lại và chu kỳ thói quen hoặc tâm trạng. Truyền ngày bắt đầu như điểm bạn muốn lần trở về tiếp theo sau - thường là hôm nay, hoặc ngày của lần trở về cuối cùng - và điểm cuối đi tiếp đến lần tiếp theo. Việc ghi đè vị trí tùy chọn cho phép bạn tạo biểu đồ trở về cho bất cứ nơi nào người đó thực sự trong tháng đó thay vì nơi sinh của họ, điều này quan trọng đối với các nhạy cảm góc độ. Liên tiếp các cuộc gọi để xây dựng một chuỗi biểu đồ hàng tháng.
Notes
Điểm cuối trả về lần trở về tiếp theo đơn lẻ vào hoặc sau ngày được cung cấp, không phải một chuỗi - gọi lặp lại, tiến ngày bắt đầu, để xây dựng một chuỗi. Con số ~27.3 ngày là tháng sideral, vì vậy các lần trở về trôi so với lịch. Nếu không có vị trí được cung cấp, biểu đồ được tạo tại nơi sinh; một ghi đệch chỉ di chuyển lại các góc và nhà. Cung hoàng đạo nhiệt đới và Swiss Ephemeris xuyên suốt.
Try the Trăng Trở về API
Grab a key and make your first call in under a minute.