Перейти до вмісту
AstroWay/api v2.158.7 · docs
усі системи в нормі

Moon Phase

POST
/moon-phase
request.sh
curl -X POST https://api.astroway.info/v1/moon-phase \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{ "date": "2024-01-25", "time": "12:00:00", "latitude": 0, "longitude": 0, "timezoneOffset": 0 }'

Current moon phase at a given moment: illumination %, age in days, elongation, waxing/waning, sun + moon zodiac signs. Geocentric Sun-Moon elongation per Meeus Ch.48.

Media type application/json

Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC. city is a display label only: nothing here geocodes it, so it never stands in for coordinates.

object
date required
string
/^\d{4}-\d{2}-\d{2}$/
time required
string
/^\d{2}:\d{2}:\d{2}$/
timezoneOffset

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

number
0 nullable >= -14 <= 14
latitude required
number
>= -90 <= 90
longitude required
number
>= -180 <= 180
houseSystem
string
default: P
name
string
""
city
string
""
zodiacType
string
Allowed values: tropical sidereal
ayanamsaId
number
nullable
ayanamsa

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

string
Allowed values: fagan-bradley lahiri de-luce raman krishnamurti kp yukteshwar jn-bhasin true-citra djwhal-khul
cosmogram
boolean
key additional
nullable
Example
{
"date": "2024-01-25",
"time": "12:00:00",
"latitude": 0,
"longitude": 0,
"timezoneOffset": 0
}

Successful calculation

Media type application/json
object
ok
boolean
data
object
phase
number
nullable
phaseName
string
nullable
majorPhase
string
nullable
illuminationPercent
number
nullable
elongationDeg
number
nullable
ageDays
number
nullable
waxing
boolean
nullable
moonSign
string
nullable
sunSign
string
nullable
moonLongitude
number
nullable
sunLongitude
number
nullable
Example
{
"ok": true,
"data": {
"phase": 0.999,
"phaseName": "Full Moon",
"majorPhase": "full_moon",
"illuminationPercent": 99.94,
"elongationDeg": 177.25,
"ageDays": 14.54,
"waxing": true,
"moonSign": "Leo",
"sunSign": "Aquarius",
"moonLongitude": 122.24,
"sunLongitude": 304.99
}
}

Validation error

Media type application/json
Example
{
"ok": false,
"error": {
"code": "INVALID_INPUT",
"message": "Validation failed: date: Date must be YYYY-MM-DD",
"details": [
{
"path": "date",
"message": "Date must be YYYY-MM-DD"
}
]
}
}

Missing or invalid API key

Media type application/json
Example
{
"ok": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid API key"
}
}
Корисно?