Peta Natal

Endpoint POST /v1/chart - dasar kebanyakan permintaan. Mengembalikan peta natal lengkap: posisi planet, cusp rumah, aspek antar planet, sektor peta. Biaya: 20 kredit (Tier 2).

Parameter permintaan

Parameter	Tipe	Wajib	Deskripsi
date	string	Ya	Tanggal lahir YYYY-MM-DD
time	string	Ya	Waktu lahir HH:mm:ss atau HH:mm (dibaca sebagai HH:mm:00)
timezoneOffset	number	Ya	Selisih dari UTC dalam jam (mis. 2 untuk Kyiv musim panas)
latitude	number	Tidak (0)	Lintang dalam derajat desimal
longitude	number	Tidak (0)	Bujur dalam derajat desimal
houseSystem	string	Tidak (P)	Sistem rumah: P Placidus, K Koch, W Whole Sign, E Equal dan lainnya
name	string	Tidak	Nama (dikembalikan dalam respons)
city	string	Tidak	Kota (dikembalikan dalam respons)
zodiacType	string	Tidak	tropical (default) atau sidereal
cosmogram	boolean	Tidak	true - tanpa rumah (ketika lokasi tidak diketahui)

Contoh permintaan

Peta natal untuk Kyiv, 14 Juli 1990, 14:30:

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const { data: chart } = await res.json();
console.log(chart.planets[0]); // Sun position

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    },
)
chart = r.json()['data']
print(chart['planets'][0])  # Sun position

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
        'houseSystem' => 'P',
    ],
]);

$chart = json_decode($r->getBody(), true)['data'];
print_r($chart['planets'][0]); // Sun position

Contoh respons

{
  "input": {
    "name": "",
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P",
    "city": "",
    "cosmogram": false
  },
  "julianDay": 2448086.979167,
  "siderealTime": 6.971672,
  "planets": [
    {
      "id": 0,
      "name": "Sun",
      "longitude": 111.77244,
      "latitude": 0.000162,
      "distance": 1.016462,
      "speedLong": 0.953753,
      "isRetrograde": false,
      "declination": 21.681363
    },
    {
      "id": 1,
      "name": "Moon",
      "longitude": 9.061363,
      "latitude": 4.639701,
      "distance": 0.002511,
      "speedLong": 13.770219,
      "isRetrograde": false,
      "declination": 7.854711
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [
      212.0953,
      239.7536,
      274.2018,
      312.6334,
      346.2069,
      12.1755,
      32.0953,
      59.7536,
      94.2018,
      132.6334,
      166.2069,
      192.1755
    ],
    "ascendant": 212.0953,
    "mc": 132.6334
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": {
        "name": "Conjunction",
        "angle": 0,
        "isMajor": true
      },
      "orb": 0.548,
      "isApplying": true
    }
  ],
  "chartSect": "diurnal"
}

Catatan

Respons dipersingkat untuk kejelasan. Respons lengkap mencakup 13 benda, 12 cusp rumah, dan semua aspek di antaranya. Pada field name setiap benda terdapat nama dari Swiss Ephemeris, bukan nama astrologi: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Node Utara, sebenarnya), mean Apogee (Lilith, rata-rata), Chiron. Node Selatan tidak dikembalikan sebagai benda terpisah: itu true Node plus 180°.

Nama dalam bahasa kamu

Tambahkan ?lang=, untuk mendapatkan nama planet, tanda, dan aspek dalam bahasa ini bersama dengan identifier bahasa Inggris yang tidak berubah. Semua 21 bahasa didukung, misalnya bahasa Jerman:

curl -X POST "https://api.astroway.info/v1/chart?lang=de" \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-07-14", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.4501, "longitude": 30.5234, "houseSystem": "P" }'

{
  "localized": {
    "planets": { "Sun": "Sonne", "Moon": "Mond", "Mercury": "Merkur" },
    "signs": { "cancer": "Krebs", "leo": "Löwe", "aries": "Widder" },
    "aspects": { "Conjunction": "Konjunktion", "Opposition": "Opposition" }
  }
}

Tanpa ?lang= blok localized tidak ada dalam respons.

Sistem rumah

Kode	Sistem	Catatan
P	Placidus	Default, paling populer
K	Koch	Populer di Jerman
W	Whole Sign	Klasik hellenistik
E	Equal	Setara dari ASC
R	Regiomontanus	Astrologi horary
C	Campanus	Sistem ruang
T	Topocentric	Polich-Peij
B	Alcabitius	Tradisi abad pertengahan

Daftar lengkap dengan 15 sistem - di API reference.

Kosmogram (tanpa lokasi kelahiran)

Jika waktu kelahiran diketahui, tapi lokasi tidak, kirim "cosmogram": true. Rumah dan ASC/MC tidak dihitung, kredit tetap sama (20).

Header respons

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 8aec43e9bc749b37e998a489bbad1757

Selanjutnya

• Sinistri: kompatibilitas dua peta
• Transit: overlay transit dan kalender acara
• Human Design: peta HD lengkap
• Referensi API lengkap: semua endpoint 771