クライアントSDK

AstroAPIは、一般的なプログラミング言語向けのクライアントSDKを提供しています。これらのSDKはOpenAPI仕様から生成されており、すべてのAPIエンドポイントへのタイプセーフなアクセスを提供します。

利用可能なSDK

言語	ダウンロード	説明
TypeScript	ダウンロード	Fetch APIを使用した完全な型定義付きTypeScriptクライアント
JavaScript	ダウンロード	Promise ベースのAPIを持つJavaScriptクライアント
Python	ダウンロード	requests ライブラリを使用したPythonクライアント
PHP	ダウンロード	PSR-7 HTTPサポート付きPHPクライアント

インストール

TypeScript / JavaScript

SDKを展開してプロジェクトに追加する：

unzip astroapi-sdk-typescript.zip -d ./astroapi-sdk

インポートして使用する：

import { Configuration, CalculationsApi } from "./astroapi-sdk";

const config = new Configuration({
    basePath: "https://api.astroapi.cloud",
    headers: {
        "X-Api-Key": "your-api-key"
    }
});

const api = new CalculationsApi(config);

const chart = await api.postApiCalcNatal({
    datetime: "1990-06-15T14:30:00",
    latitude: 51.5074,
    longitude: -0.1278,
    timezone: "Europe/London"
});

Python

展開して依存関係をインストールする：

unzip astroapi-sdk-python.zip -d ./astroapi
cd astroapi
pip install -r requirements.txt

使用方法：

from astroapi import Configuration, ApiClient, CalculationsApi

configuration = Configuration(
    host="https://api.astroapi.cloud"
)
configuration.api_key["X-Api-Key"] = "your-api-key"

with ApiClient(configuration) as api_client:
    api = CalculationsApi(api_client)
    chart = api.post_api_calc_natal(
        datetime="1990-06-15T14:30:00",
        latitude=51.5074,
        longitude=-0.1278,
        timezone="Europe/London"
    )

PHP

展開してComposer経由でインストールする：

unzip astroapi-sdk-php.zip -d ./astroapi
cd astroapi
composer install

使用方法：

<?php
require_once(__DIR__ . '/vendor/autoload.php');

$config = AstroAPI\Configuration::getDefaultConfiguration()
    ->setHost('https://api.astroapi.cloud')
    ->setApiKey('X-Api-Key', 'your-api-key');

$apiInstance = new AstroAPI\Api\CalculationsApi(
    new GuzzleHttp\Client(),
    $config
);

$chart = $apiInstance->postApiCalcNatal(
    '1990-06-15T14:30:00',
    51.5074,
    -0.1278,
    'Europe/London'
);

SDK生成

別の言語のSDKが必要な場合は、自分で生成できます：

npx @openapitools/openapi-generator-cli generate \
  -i https://api.astroapi.cloud/openapi \
  -g <generator-name> \
  -o ./output

利用可能なジェネレーターの完全なリストについては、OpenAPI Generatorドキュメントを参照してください。

次のステップ

• はじめに - クイックスタートガイド
• 認証 - APIキーの設定
• APIリファレンス - 完全なエンドポイントドキュメント