Sao di chuyển

Hai endpoint để làm việc với quá cảnh:

Endpoint	Tín dụng	Chức năng
POST /v1/transits	50	Biểu đồ quá cảnh cho một ngày cụ thể, được phủ lên vị trí sinh
POST /v1/transit-calendar	100	Lịch các sự kiện quá cảnh trong một khoảng thời gian

Nếu bạn muốn xem kết quả cuối cùng trông như thế nào trước: quá cảnh trong ứng dụng AstroWay tính toán cùng một thứ và vẽ một lớp phủ trên bánh xe.

POST /v1/transits: lớp phủ

Tính toán vị trí các hành tinh vào ngày quá cảnh đã cho trong tọa độ của vị trí sinh.

Tham số

Tất cả các tham số của biểu đồ sinh (date, time, timezoneOffset, latitude, longitude, houseSystem) cộng thêm:

Tham số	Kiểu	Bắt buộc	Mô tả
transitDate	string	Có	Ngày quá cảnh YYYY-MM-DD
transitTime	string	Không (12:00:00)	Thời gian quá cảnh HH:mm:ss
transitTzOffset	number	Không (0)	Độ lệch múi giờ quá cảnh

Ví dụ

cURL

curl -X POST https://api.astroway.info/v1/transits \
  -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,
    "transitDate": "2026-04-14",
    "transitTime": "12:00:00",
    "transitTzOffset": 3
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/transits', {
  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,
    transitDate: '2026-04-14', transitTime: '12:00:00', transitTzOffset: 3,
  }),
});
const { data: transits } = await res.json();
console.log(transits.planets); // Transit planet positions

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/transits',
    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,
        'transitDate': '2026-04-14', 'transitTime': '12:00:00', 'transitTzOffset': 3,
    },
)
transits = r.json()['data']
print(transits['planets'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('transits', [
    '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,
        'transitDate' => '2026-04-14',
        'transitTime' => '12:00:00',
        'transitTzOffset' => 3,
    ],
]);

$transits = json_decode($r->getBody(), true)['data'];
print_r($transits['planets']);

Phản hồi

Cấu trúc tương tự như /v1/chart - một biểu đồ đầy đủ với các hành tinh, nhà, góc hợp, nhưng được tính toán cho ngày quá cảnh.

---

POST /v1/transit-calendar: lịch sự kiện

Quét một khoảng thời gian và trả về danh sách các sự kiện quá cảnh: các góc hợp chính xác của các hành tinh quá cảnh với các hành tinh sinh, nhập cung, nghịch hành.

Tham số bổ sung

Tham số	Kiểu	Bắt buộc	Mô tả
startDate	string	Có	Ngày bắt đầu khoảng thời gian YYYY-MM-DD
endDate	string	Có	Ngày kết thúc khoảng thời gian YYYY-MM-DD

Chú ý

Khoảng thời gian tối đa 365 ngày. Khoảng thời gian càng rộng, thời gian tính toán càng lâu (thường là 0.5–2 giây). Chi phí: 100 tín dụng bất kể độ dài khoảng thời gian.

Ví dụ

cURL

curl -X POST https://api.astroway.info/v1/transit-calendar \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "natal": {
      "date": "1990-07-14",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.4501,
      "longitude": 30.5234
    },
    "startDate": "2026-04-01",
    "endDate": "2026-04-30"
  }'

TypeScript

const r = await fetch('https://api.astroway.info/v1/transit-calendar', {
  method: 'POST',
  headers: { 'X-Api-Key': apiKey, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    natal: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
    startDate: '2026-04-01',
    endDate: '2026-04-30',
  }),
});
const { data: calendar } = await r.json();

for (const event of calendar.events) {
  console.log(`${event.date}: #${event.transitPlanetId} ${event.aspect.name} #${event.natalPlanetId}`);
}

Python

r = requests.post(
    'https://api.astroway.info/v1/transit-calendar',
    headers={'X-Api-Key': apiKey},
    json={
        'natal': {
            'date': "1990-07-14",
            'time': "14:30:00",
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
        'startDate': "2026-04-01",
        'endDate': "2026-04-30"
    },
)
calendar = r.json()['data']

for event in calendar["events"]:
    print(f"{event['date']}: #{event['transitPlanetId']} {event['aspect']['name']} #{event['natalPlanetId']}")

PHP

<?php
use GuzzleHttp\Client;

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

$calendar = json_decode($r->getBody(), true)['data'];
foreach ($calendar['events'] as $e) {
    echo "{$e['date']}: #{$e['transitPlanetId']} {$e['aspect']['name']} #{$e['natalPlanetId']}\n";
}

Ví dụ phản hồi

{
  "startDate": "2026-04-01",
  "endDate": "2026-04-30",
  "maxOrb": 1,
  "count": 42,
  "events": [
    {
      "jd": 2461132.97998,
      "date": "2026-04-02T11:31:10.000Z",
      "transitPlanetId": 2,
      "natalPlanetId": 9,
      "aspect": { "name": "Trine", "i18nKey": "aspect_trine", "angle": 120, "orb": 12, "symbol": "△", "isMajor": true, "color": "#3366cc" },
      "transitLongitude": 345.005969,
      "natalLongitude": 225.005747,
      "isRetrograde": false
    }
  ]
}

Các endpoint liên quan

Endpoint	Tín dụng	Chức năng bổ sung
/v1/forecast-calendar	100	Dự báo hàng năm - bản đồ nhiệt 365 ngày
/v1/progressions	50	Tiến trình thứ cấp
/v1/solar-return	50	Hoàn cung (biểu đồ hàng năm)
/v1/aspect-timeline	100	Dòng thời gian các góc hợp trong một khoảng thời gian

Tiếp theo

• Biểu đồ sinh: yêu cầu cơ bản
• Hợp đồ: khả năng tương thích của hai biểu đồ
• Human Design: biểu đồ HD đầy đủ
• Tài liệu tham khảo API: tất cả 771 endpoint