API Hartă Natală
Transformă un moment de naștere într-o hartă natală completă, structurată - planete, cusps ale caselor, aspecte și date unghiulare - într-un singur POST. Zodiac tropical, treisprezece sisteme de case, precizie Swiss Ephemeris, JSON la ieșire.
API Hartă Natală
Endpoint-ul hărții natale rezolvă data nașterii, ora ceasului și decalajul UTC într-o zi Iuliană precisă, apoi solicită motorului Swiss Ephemeris longitudinea, latitudinea și viteza geocentrică a fiecărui corp - cele zece planete clasice plus nodurile lunare, Chiron și Luna Neagră Lilith. Derivează Ascendentul și Mijlocul Cerului din latitudinea și longitudinea nașterii, împarte casele conform sistemului ales, atribuie fiecare planetă la semnul și casa sa, și calculează grila completă de aspecte cu flag-uri de aplicare/separare și orbite exacte. Mișcarea retrogradă este marcată din viteza corpului, iar secta hărții (naștere de zi sau de noapte) este returnată astfel încât interpretarea ulterioară să poată pondera corect beneficii și maleficii.
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-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,
"houseSystem": "P"
}'{
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
}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). |
| houseSystem | string | no | One-letter Swiss Ephemeris code - P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
When to use it
Apelează acest endpoint ori de câte ori ai nevoie de coloana vertebrală structurală a unui horoscop: un widget de hartă natală, un raport natal, un flux de onboarding care personalizează conținutul în funcție de Soare/Lună/Ascendent, sau un agent AI care are nevoie de pozițiile brute înainte de a interpreta orice. Este apelul premergător pentru sinastrie, tranzite, progresii și majoritatea tipurilor de rapoarte - calculează harta o singură dată, cachează JSON-ul și alimentează endpoint-urile mai grele în loc să recalculezi de fiecare dată. Deoarece răspunsul este pură date (fara proză, fără imagini), se integrează perfect în orice stivă: randează-l singur, pasează-l unui LLM sau înmânează-l unuia dintre endpoint-urile noastre de randare SVG.
Notes
Valorile implicite urmează convenția occidentală mainstream: zodiac tropical, case Placidus, "Big Three" Soare–Lună–Ascendent. Motorul este Swiss Ephemeris (Astrodienst) și partajat cu calculatorul din browser, astfel încât serverul și clientul să fie de acord cu secundara de arc. Casele revin la Porphyry deasupra cercului polar unde Placidus este nedefinit.
Try the Harta Natală API
Grab a key and make your first call in under a minute.