Lịch sinh

Endpoint POST /v1/chart - nền tảng của hầu hết các yêu cầu. Trả về bản đồ sinh đầy đủ: vị trí các hành tinh, cuspid nhà, khía cạnh giữa các hành tinh, sector của bản đồ. Giá: 20 credits (Tier 2).

Tham số yêu cầu

Tham số	Kiểu	Bắt buộc	Mô tả
date	string	Có	Ngày sinh YYYY-MM-DD
time	string	Có	Giờ sinh HH:mm:ss hoặc HH:mm (đọc là HH:mm:00)
timezoneOffset	number	Có	Độ lệch so với UTC tính bằng giờ (ví dụ 2 cho Kyiv vào mùa hè)
latitude	number	Không (0)	Vĩ độ ở độ thập phân
longitude	number	Không (0)	Kinh độ ở độ thập phân
houseSystem	string	Không (P)	Hệ thống nhà: P Placidus, K Koch, W Whole Sign, E Equal và khác
name	string	Không	Tên (được trả về trong phản hồi)
city	string	Không	Thành phố (được trả về trong phản hồi)
zodiacType	string	Không	tropical (mặc định) hoặc sidereal
cosmogram	boolean	Không	true - không có nhà (khi vị trí không xác định)

Ví dụ yêu cầu

Bản đồ sinh cho Kyiv, ngày 14 tháng 7 năm 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

Ví dụ phản hồi

{
  "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"
}

Ghi chú

Phản hồi được rút gọn để dễ nhìn. Phản hồi đầy đủ bao gồm 13 thiên thể, 12 cuspid nhà và tất cả các khía cạnh giữa chúng. Trong trường name của mỗi thiên thể có tên từ Swiss Ephemeris, không phải tên chiêm tinh: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Cực Bắc, thật), mean Apogee (Lilith, trung bình), Chiron. South Node không được trả về như một thiên thể riêng: nó là true Node cộng 180°.

Tên bằng ngôn ngữ của bạn

Thêm ?lang= để nhận tên các hành tinh, cung và khía cạnh bằng ngôn ngữ này kèm theo các định danh tiếng Anh không thay đổi. Hỗ trợ bất kỳ trong 21 ngôn ngữ, ví dụ tiếng Đức:

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" }
  }
}

Nếu không có ?lang= thì khối localized trong phản hồi sẽ không có.

Hệ thống nhà

Mã	Hệ thống	Ghi chú
P	Placidus	Mặc định, phổ biến nhất
K	Koch	Phổ biến ở Đức
W	Whole Sign	Cổ điển Hellenistic
E	Equal	Bằng nhau từ ASC
R	Regiomontanus	Chiêm tinh horary
C	Campanus	Hệ thống không gian
T	Topocentric	Polich-Peij
B	Alcabitius	Truyền thống trung cổ

Danh sách đầy đủ với 15 hệ thống - trong API reference.

Cosmogram (không có nơi sinh)

Nếu thời gian sinh đã biết, nhưng nơi sinh không, gửi "cosmogram": true. Các nhà và ASC/MC không được tính, số credit vẫn như cũ (20).

Tiêu đề phản hồi

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

Tiếp theo

• Synastry: tương thích của hai bản đồ
• Transits: lớp phủ chuyển vị và lịch sự kiện
• Human Design: bản đồ HD đầy đủ
• Full API reference: tất cả 771 endpoint