API Bintang Tetap
Di luar planet-planet yang bergerak, lapisan astrologi yang lebih tua membaca bintang-bintang tetap - Regulus, Spica, Algol, Aldebaran dan rekan-rekan mereka. Endpoint ini memindai peta kelahiran untuk konjungsi erat dengan bintang-bintang utama tersebut dan mengembalikan setiap kontak dengan orb-nya, sehingga Anda dapat memasukkan karakter bintang yang diketahui ke dalam bacaan.
API Bintang Tetap
Dari tanggal, waktu, offset UTC, dan koordinat kelahiran yang disediakan, endpoint ini menghitung titik-titik natal dan kemudian menelusuri katalog bintang-bintang tetap utama yang diambil dari tradisi Vivian Robson dan Ptolemy - bintang-bintang yang terang dan berbobot astrologis, bukan seluruh langit. Untuk setiap bintang, endpoint menguji titik-titik natal untuk konjungsi, dan ketika satu jatuh di dalam orb, ia mencatat kontak bersama dengan orb pemisahan yang tepat. Output di bawah data.stars adalah daftar kontak bintang-ke-titik: bintang mana, titik natal mana yang disentuh, dan seberapa dekat kesejajarannya, sehingga konjungsi setengah derajat dianggap lebih kuat daripada yang di tepi orb. Hanya konjungsi yang dipertimbangkan - teknik ini memperlakukan bintang sebagai signifikan ketika titik chart berada di atasnya, bukan ketika membentuk sudut longitudinal yang planet buat satu sama lain. Ini menampilkan bintang-bintang bernama yang sumber klasifikasikan sebagai beruntung atau berbahaya, siap untuk dipasangkan dengan salinan makna bintang Anda sendiri.
POST/v1/fixed-stars
curl -X POST https://api.astroway.info/v1/fixed-stars \
-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
}'{
"ok": true,
"data": {
"stars": [
{
"star": "Regulus",
"point": "Mercury",
"orb": 0.4
},
{
"star": "Algol",
"point": "Mars",
"orb": 1.1
}
]
}
}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). |
When to use it
Gunakan endpoint ini ketika bacaan chart menginginkan tekstur tambahan dari bintang-bintang bernama - seorang penafsir tradisional atau sadar bintang tetap, generator laporan yang menandai kontak Algol yang mencolok atau bintang kerajaan Regulus, atau alat edukatif yang mengajarkan legenda di balik bintang-bintang terang. Desain orb-erat dan hanya-konjungsi menjaga output tetap fokus: Anda mendapatkan sejumlah kontak yang layak disebutkan daripada kebisingan, yang membuatnya mudah dirender sebagai daftar sorotan yang singkat. Berikan data kelahiran yang sama yang Anda kirim ke endpoint peta kelahiran, dan kontak bintang akan sejajar dengan posisi planet dan sudut yang sudah ada di chart Anda, memungkinkan Anda memberi catatan pada planet atau sudut dengan bintang yang berlokasi sama. Karena katalognya dipilih untuk bintang-bintang yang secara tradisional signifikan, Anda dapat melampirkan teks interpretasi yang telah disiapkan ke masing-masing tanpa harus memilih daftar sendiri.
Notes
Katalog bintang mengikuti pemilihan yang diturunkan melalui Vivian Robson dan Ptolemy - bintang-bintang tetap utama yang signifikan secara astrologis, bukan survei langit yang menyeluruh. Posisi natal dan bujur bintang dihitung oleh mesin Swiss Ephemeris (Astrodienst) di zodiak tropis, dan hanya konjungsi di dalam orb yang dikembalikan.
Try the Bintang Tetap API
Grab a key and make your first call in under a minute.