エンジニアリングノート
エフェメリッドの精度、計算アーキテクチャ、MCPプロトコル、その他のドキュメントに収まらない細かいことについて。
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
→Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
→Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
→How Accurate Is the Swiss Ephemeris? Verified Benchmarks
Swiss Ephemeris accuracy in numbers, and how a hosted API measures up: 231 of 231 positions within tolerance against NASA JPL Horizons, a median 0.0013 arcsecond against the swetest reference output, exact house cusps, eclipses within a minute.
→Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)
pyswisseph vs a REST API for Swiss Ephemeris calculations - C dependencies, data files, licensing and deployment compared, with a decision guide.
→X-Cache header: cache-status の可視化によるクライアント統合の最適化
各 response API は今では X-Cache: MISS | HIT | BYPASS を含み、クライアントはすぐにリクエストがゼロから計算されたか、キャッシュから取得されたかを確認できます。これにより、/dashboard/usage に cache hit % 列が表示され、guesswork なしでインテグレーションを最適化できるようになります。
→Eclipse path, cosmogram と Vedicマップ: pure-SVG ビジュアライザー（headless-Chromeなし）
6つの endpoint /v1/render/* ファミリーは特定のビジュアライゼーション用 - 3つの Vedicマップ (North/South/East Indian)、Hamburg-School 90° cosmogram、equirectangular eclipse-path、ステレオグラフィック star-map。すべてのレンダーは純粋な SVG文字列、ブラウザーワーカーなし。
→Reports V2: 12個のendpointの代わりに1つ - `/v1/reports/generate`
12 type-specific ルート /reports/natal, /reports/synastry, … の代わりに、report_type フィールドを持つ統一された endpoint POST /v1/reports/generate が1つです。SDK コンシューマは12個の代わりに1つのメソッドを取得し、MCP カタログは12ツールから1つに縮小されます。
→