SDK Máy khách

AstroAPI cung cấp các SDK máy khách cho các ngôn ngữ lập trình phổ biến. Các SDK này được tạo ra từ đặc tả OpenAPI của chúng tôi và cung cấp quyền truy cập an toàn kiểu dữ liệu vào tất cả các endpoint API.

Các SDK Có sẵn

Ngôn ngữ	Tải xuống	Mô tả
TypeScript	Tải xuống	Client TypeScript với đầy đủ định nghĩa kiểu dữ liệu sử dụng Fetch API
JavaScript	Tải xuống	Client JavaScript với API dựa trên Promise
Python	Tải xuống	Client Python sử dụng thư viện requests
PHP	Tải xuống	Client PHP với hỗ trợ HTTP PSR-7

Cài đặt

TypeScript / JavaScript

Giải nén SDK và thêm vào dự án của bạn:

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

Import và sử dụng:

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

Giải nén và cài đặt các phụ thuộc:

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

Cách sử dụng:

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

Giải nén và cài đặt qua Composer:

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

Cách sử dụng:

<?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'
);

Tạo SDK

Nếu bạn cần SDK cho một ngôn ngữ khác, bạn có thể tự tạo:

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

Xem tài liệu OpenAPI Generator để biết danh sách đầy đủ các bộ tạo có sẵn.

Bước tiếp theo

• Bắt đầu - Hướng dẫn khởi động nhanh
• Xác thực - Thiết lập API key
• Tài liệu API - Tài liệu endpoint đầy đủ