How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
APIの数秘術: 1つのルートで5つの計算システム
ほとんどのAPIは数秘術を持たないか、ピタゴラス式のシステムだけを提供します。当社は5つの完全なシステム(ピタゴラス式、ハルデア式、2つのカバラ式、ヴェーダ式)それぞれ10件の計算を、1つのパラメータ化されたルートで提供します。プラス、22アルカナの運命マトリックス。
カタログマップ: AstroWay の 700+ エンドポイントの構成
API は 57 グループにわたる 700 以上のエンドポイントに成長しました - ネイタルチャートから BaZi、ジオマンティー、SVG マップのレンダリングまで。カタログがドメインに分割され、すべての呼び出しが単一パターンで行われる方法と、必要なエンドポイントを素早く見つける方法を解説します。
3つの公式SDK: TypeScript、Python、PHP - 生のcurlの代わりに
生のHTTPは動作しますが、型付けされたクライアントは時間を節約します: パスの自動補完、リクエストとレスポンスの型、408/409/429/5xx用の組み込みリトライ、Stainlessスタイルのエラーヒエラルキー。3つの公式SDK - @astroway/sdk (npm)、astroway (PyPI)、astroway/sdk (Packagist) - と、それらが1つのOpenAPI契約から生成される方法を解説します。
Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
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.
X-Cache header: cache-status の可視化によるクライアント統合の最適化
各 response API は今では X-Cache: MISS | HIT | BYPASS を含み、クライアントはすぐにリクエストがゼロから計算されたか、キャッシュから取得されたかを確認できます。これにより、/dashboard/usage に cache hit % 列が表示され、guesswork なしでインテグレーションを最適化できるようになります。
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つに縮小されます。
API でヴェーダ占星術: パラーシャラからラール・キターブまで 354 のエンドポイント
AstroWay は商用 API の中で最も充実したヴェーダ占星術のカバレッジを提供しています: 10 種類のダシャー体系、16 のヴァルガ、パンチャーンガ、ラール・キターブ + KP + ジャイミニの全機能。仕組みと、どの技法をいつ選ぶべきかを解説します。
WordPress不要のホワイトラベルPDF:1つのフィールドによるインラインブランディング
すべての12エンドポイント/v1/reports/*のスキーマ内のwhitelabelフィールドは、ブール値(DB設定を読み取る)だけでなく、15フィールドを持つインラインオブジェクトも受け入れるようになりました。これによりWordPressユーザーへの依存が解除され、どのSaaS APIコンシューマーも、別途管理ページを設けることなくPDFをリアルタイムにブランド化できます。
アストロロジーアプリの構築方法: 開発者向けの完全ガイド
アストロロジーアプリの作成方法 - APIの選択、設計、最初のナタールチャート、シナストリーとトランジットの追加、デプロイ
アストロロジーAPIのクイックスタート: TypeScriptとPythonで5分間
SDKのインストール、APIキーの取得、最初のナタールチャートのリクエスト。5分で動作するJSONを手に入れる(TypeScriptとPython)
Rectification API: 開発者のための出生時刻の修正
レクティファイ (出生時刻修正) とは、人生の出来事をもとに、不明または不正確な出生時刻を絞り込むプロセスです。この記事では、アルゴリズムによる手法と Trutine of Hermes を使って、API でそれを自動化する方法を紹介します。
Solar Fireと同じSwiss Ephemeris - 4行のコードで。
無料のキー(カード不要)。最初の支払いまでに月5,000回の呼び出し。