Çin metafiziği API'si

Dört aileye dağılmış 53 endpoint: BaZi (18), Çin takvimi ve zodyağı (15), Zi Wei Dou Shu (14) ve I Ching (6). Takvim tarih tablolarından değil efemeristen türetilir, bu yüzden 2 ile 2899 arasındaki yıllarda çalışır ve birinin başvuru tablosunu güncelleyip güncellemediğine bağlı değildir.

Neler dahil

Aile	Endpoint	Durum
BaZi: sütunlar ve analiz	18	Eksiksiz klasik donanım
Takvim, zodyak, feng shui, Tong Shu	15	Efemeristen türetilir
Zi Wei Dou Shu	14	Yıldız yerleşimi hesaplanır, on bir başvuru tablosu başvuru tablosu olarak kalır
I Ching	6	Heksagramlar, yazı tura atışı, değişen çizgiler

Ücretsiz bir kütüphaneden farkı nedir

Dürüst yanıt: yalnızca dört sütuna ihtiyacınız varsa lunar-typescript kullanın. MIT lisanslıdır, sizin sürecinizde, çevrim dışı, hız sınırı olmadan hesaplar ve bunun için ödeme yapmanız gerekmez.

Fark, kütüphanenin bittiği yerde başlar.

Ne	MIT lisanslı kütüphaneler	AstroWay API
Dört sütun, 藏干, 纳音, 十神	evet	evet
Ekollerin ayrıştığı yerlerde her iki okumasıyla 神煞	hayır	evet
Dal etkileşimleri 刑冲合害	hayır	evet
扶抑 çerçevesinde gün efendisinin gücü	hayır	evet
Ayrı bir hesaplama olarak gerçek güneş zamanı	hayır	evet
Oturuş ve cepheye göre uçan yıldızlar, Gua sayısı	hayır	evet
Faaliyete göre filtreli Tong Shu tarih seçimi	hayır	evet
Yirmi bir dil	hayır	evet
PHP, JavaScript ve Python için aynı anda tek bir kural	hayır	evet

Son satır, genellikle para ödenen şeyin ta kendisidir. Sitesi PHP’de, uygulaması JavaScript’te ve cron’ları Python’da olan bir ekip, aksi hâlde yıl sınırının üç uygulamasını tutar ve er ya da geç aynı doğum tarihi için üç farklı yanıt alır.

Kurallar açıkça belirtilmiş

Hesaplayıcıların ayrıştığı dört eksen var ve hiçbiri hata değil. Uygulamaların çoğu sessizce seçer; biz seçimi yanıta yazıyoruz ve harici bir CC0 veri setine karşı çalıştırılmış bir kurallar sayfası tutuyoruz.

Eksen	Bizim yanıtımız
Yıl sınırı	立春 Lichun, efemeristen alınan kesin an
Gün sınırı	23:00, erken 子時 bir sonraki güne aittir
Gerçek güneş zamanı	varsayılan olarak kapalı, bir bayrakla açılır
Yaz saati	istemcinin gönderdiği timezoneOffset ile çözülür

Örnek

curl

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

TypeScript

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const r = await aw.client.POST('/bazi/chart', {
  body: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3 },
});
console.log(r.data?.data?.pillars.map((p) => p.pillar));
// [ 'Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei' ]

Python

import os
from astroway import Astroway

aw = Astroway(api_key=os.environ["ASTROWAY_API_KEY"])

chart = aw.post("/bazi/chart", body={
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
})
print([p["pillar"] for p in chart["pillars"]])
# ['Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei']

Tiplendirilmiş metotlar

BaZi analiz rotaları mevcut SDK sürümünden sonra geldi, bu yüzden şimdilik tiplendirilmiş aw.bazi.chart(...) metotları yok. Yukarıdaki örnekler, bugünden itibaren herhangi bir yolla çalışan ham istemciyi kullanır. Tiplendirilmiş sarmalayıcılar bir sonraki SDK sürümüyle gelecek.

Klonlanabilecek hazır bir uygulama

Canlı demo ve GitHub’daki kod, MIT.

İki çağrı, 20 krediye POST /v1/bazi/chart ve 10 krediye POST /v1/bazi/luck-pillars, gizli gövdeler, nayin ve on iki evreyle dört sütunu, güç hükmüyle birlikte gün efendisini, element dengesini, sembolik yıldızları, dal etkileşimlerini ve on yıllık Da Yun döngüsünü döndürür. Uygulama bunları çizer: klasik yazımdaki gibi yıl sağda, gün sütunu işaretli. Backend tek bir rotadır ve hiçbir bağımlılığı yoktur, çünkü asıl mesele de budur: tarayıcı API’ye doğrudan erişemez, bu yüzden anahtar sunucuda yaşar.

git clone https://github.com/astroway/starter-bazi
cd starter-bazi && npm install
cp .env.example .env     # your key goes here
npm run dev

Ondan almaya değer üç şey. Fark değil, bölge adı gönderin: 1990-05-15 tarihinde Asia/Shanghai UTC+9’dur, çünkü Çin 1986’dan 1991’e kadar yaz saati uyguladı. Dili gönderin: varsayılan Ukraynacadır ve onsuz İngilizce bir sayfa element adlarını yanlış dilde alır. Cinsiyeti gönderin: Da Yun ona bağlı olarak ileri ya da geri gider, nötr bir değer yoktur.

Diller

Hayvanlar, elementler, yin ve yang, saraylar ve on iki evre 21 dile çevrilmiştir. ?lang=es ekleyin, İngilizce token’ın yanında bir *Name alanı belirir. İngilizce alanlar asla değişmez: yerelleştirme ekler, yerine koymaz.

Gövdeler, dallar, yıldız adları ve 纳音 bilinçli olarak çevrilmez: uluslararası adları, Çince karakterin yanındaki pinyindir.

Dokümantasyon bölümleri

Genel bakış Neler hesaplanır, neler yok ve neden.

BaZi: dört sütun On sekiz endpoint ve ekollerin ayrıştığı beş nokta.

Zodyak ve takvim Üç hayvan, ay takvimi tarihi, yirmi dört güneş dönemi.

Zi Wei Dou Shu Yıldız yerleşimi, on iki saray ve dört ekol anahtarı.

Kurallar Dört eksen ve harici bir veri setine karşı çalıştırma.

Sık sorulan sorular Bilinmeyen doğum saati, gerçek güneş zamanı, Zi Wei'nin durumu.

Uçan yıldızlar Dokuz saray, dönem, oturuş ve cephe.