ウェブサイトとアプリのための占星術API
ご自身のウェブサイトやアプリにAstroAppの力を加えられます。REST API、そしてAstroAppの一部の機能に対応したWordPressとJoomlaのプラグイン。
AstroAppのAPIを使うと、ウェブサイトやモバイルアプリからAstroAppに占星術の計算を依頼し、その結果を自社の製品の一部として表示できます。API連携には三つの系統があります。REST API、WordPressとJoomlaのプラグイン、そしてJavaScript APIです。いずれもAstroAppと同じインフラ上で、複数のデータセンターにまたがって動作し、一日に数百万件のリクエストという負荷を継続して処理できます。ホワイトラベルと独自のブランディングも利用できます。
REST API
RESTの呼び出しでチャートのデータを送ると、求めた計算の結果が返ります。REST APIは、AstroAppの次の機能を網羅しています。
- 西洋式とインド式の、いくつかのチャートスタイルでのチャートのデータとチャートの画像
- 惑星、小惑星と準惑星、ハウスとアスペクト。地心座標または測心座標で、要求に応じて黄道上の位置を赤経と赤緯に変換します
- リターン:ソーラー、ルナー、惑星のリターン、ネイタルの位置へのリターン、指定した黄道上の位置や位相へのリターン
- ネイタルチャートへのトランジットと、トランジット同士のトランジット
- 日付の範囲で絞り込めるセカンダリーとマイナーのプログレス、アングルへのプログレス
- サイン、ナクシャトラ、月宿、ターム、黄道の度数へのイングレス
- 月の状態:ボイドオブコース、月宿、ナクシャトラ、現在と次の位相
- エッセンシャルとアクシデンタルのディグニティ、全部で31種類
- サイン別とハウス別の統計
- アストロカートグラフィーのマッピングデータ
- 場所とタイムゾーン:五百万を超える場所から、都市、病院、地名、または指定した座標からの近さで検索できます。各場所には、タイムゾーンの変更の詳しい履歴があります
認証には、Basic認証またはトークンを使えます。すべての呼び出しをPostmanのコレクションで説明しており、cURL、PHP、Python、JavaScript、Node、Java、Cなど30のプログラミング言語での実例があります:AstroApp REST APIのドキュメント。同じ定義から生成したJava SDKもGitHubにあります。
JavaScript API
ウェブページにチャートを載せたいときは、JavaScript APIを使います。訪問者が出生データを入力すると、西洋式またはインド式のスタイルでチャートが表示されます。サーバー側のコーディングは必要ありません。同じライブラリで、チャートの背後にあるデータも得られます。
- 惑星:主要な惑星、小惑星、仮想の惑星、フォーチュンのパート、出生前のルネーションの黄経、黄緯、速度
- ハウスカスプ
- アスペクト。接近と分離の表示と、それぞれの正確な値を含みます
- 都市のデータベースとタイムゾーンの変更のデータベース。名前や座標からの近さで検索できます
リクエストをまったく必要としないクライアント側の関数もあります。ミッドポイント、二つの天体の間のアスペクト、ハウスとサインの配置、距離、そして書式を整えるユーティリティです。キーの利用を自分のウェブアドレスに限定できるため、誰かがページからキーをコピーしてほかの場所で使うことはできません。
キーと利用状況
キーはAstroAppアカウントの中にあるAPIの利用状況ポータルで作成、管理できます。そこではAPIの利用状況を確認することもできます。
JavaScript APIはProとFinancial Goldの各エディションに含まれています(個人での利用に限ります)。REST APIとCMSのプラグイン(JoomlaとWordPress)は、独自のサブスクリプションプランを持つ別の製品です。支払い方法を登録して毎日の無料枠から始め、初めて毎日の無料枠を超えたときに、アカウントは自動的に従量課金に移ります。登録するには、AstroAppアカウントのAPIセクションをご覧ください。そこでプランと課金のルールを詳しく確認できます。
よくある質問
APIは何を返しますか?
すべての計算にはJSONを、チャートを要求したときは画像を返します。XMLのフィードを使いたい場合は、JavaScript APIが同じデータをXMLでも提供します。
JavaScript APIを使うにはサーバーが必要ですか?
いいえ。JavaScript APIはどの静的なHTMLのページでも動作できるため、サーバーは必須ではありません。REST APIについては、HTTPリクエストを送れるプログラミング言語であればどの言語でも、ご自身のサーバーやアプリから使います。
チャートをインド式のスタイルで表示できますか?
はい。チャートの画像とJavaScriptのホイールには西洋式とインド式のスタイルがあり、計算ではインド占星術の設定のアヤナムサとヴァルガを指定できます。
場所と地理的な位置のデータベースはありますか?
はい。五百万を超える場所を、名前や指定した地理的な場所からの近さで検索でき、検索は国や州で絞り込めます。すべてのタイムゾーンの変更の履歴も含まれているため、過去の日付のチャートにはその日に有効だったタイムゾーンの規則が使われます。
結果を自社のブランドで表示できますか?
はい。ホワイトラベルと独自のブランディングが利用できます。
関連ページ
- AstroApp REST APIのドキュメント
- ホイールのスタイル:APIの画像で使えるチャートスタイル
- 予測:APIが計算するリターン、トランジット、プログレス