Sao di chuyển

Hai hai, đây là phần thân MDX đã được dịch sang tiếng Việt:

---

Hai endpoint để làm việc với các transit:

Endpoint	Credit	Mô tả
POST /v1/transits	50	Bản đồ transit vào ngày cụ thể, chồng lên vị trí natal
POST /v1/transit-calendar	100	Lịch các sự kiện transit trong khoảng thời gian

POST /v1/transits — overlay

Tính toán vị trí các hành tinh vào ngày transit đã chỉ định trong tọa độ của vị trí natal.

Tham số

Tất cả tham số của bản đồ natal (date, time, timezoneOffset, latitude, longitude, houseSystem) cộng với:

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

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 transits = await res.json();
console.log(transits.planets); // Vị trí hành tinh transit

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()
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);
print_r($transits['planets']);

Phản hồi

Cấu trúc tương tự như /v1/chart — bản đồ đầy đủ với các hành tinh, nhà, khía cạnh, nhưng được tính toán vào ngày transit.

---

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

Quét khoảng thời gian và trả về danh sách các sự kiện transit: khía cạnh chính xác của các hành tinh transit so với natal, ingress, retrograde.

Tham số bổ sung

Tham số	Kiểu	Bắt buộc	Mô tả
startDate	string	Có	Bắt đầu khoảng thời gian YYYY-MM-DD
endDate	string	Có	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 càng rộng, thời gian tính toán càng lâu (thường mất 0.5–2 giây). Chi phí: 100 credit 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 '{
    "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({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.transitPlanet} ${event.aspect} ${event.natalPlanet}`);
}

Python

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

for event in calendar["events"]:
    print(f"{event['date']}: {event['transitPlanet']} {event['aspect']} {event['natalPlanet']}")

PHP

<?php
$r = $client->post('transit-calendar', [
    '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,
        'startDate' => '2026-04-01',
        'endDate' => '2026-04-30',
    ],
]);

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

Ví dụ phản hồi

{
  "events": [
    {
      "date": "2026-04-03",
      "transitPlanet": "Mars",
      "natalPlanet": "Sun",
      "aspect": "conjunction",
      "orb": 0.12,
      "exact": true
    },
    {
      "date": "2026-04-15",
      "transitPlanet": "Jupiter",
      "natalPlanet": "Moon",
      "aspect": "trine",
      "orb": 0.45,
      "exact": true
    }
  ]
}

Các endpoint liên quan

Endpoint	Credit	Thêm gì
/v1/forecast-calendar	100	Dự báo hàng năm — heatmap trong 365 ngày
/v1/progressions	50	Tiến triển thứ cấp
/v1/solar-return	50	Sola (bản đồ hàng năm)
/v1/aspect-timeline	100	Timeline khía cạnh trong khoảng thời gian

Tiếp theo

• Bản đồ natal — yêu cầu cơ bản
• Sinastry — tương thích giữa hai bản đồ
• Human Design — bản đồ HD đầy đủ
• Tài liệu tham khảo API — tất cả các endpoint 723