SDK Client

AstroAPI fornisce SDK client per i linguaggi di programmazione più diffusi. Questi SDK sono generati dalla nostra specifica OpenAPI e forniscono accesso con tipizzazione sicura a tutti gli endpoint API.

SDK Disponibili

Linguaggio	Download	Descrizione
TypeScript	Scarica	Client TypeScript con definizioni di tipo complete tramite Fetch API
JavaScript	Scarica	Client JavaScript con API basata su Promise
Python	Scarica	Client Python che utilizza la libreria requests
PHP	Scarica	Client PHP con supporto HTTP PSR-7

Installazione

TypeScript / JavaScript

Estrai l'SDK e aggiungilo al tuo progetto:

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

Importa e utilizza:

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

Estrai e installa le dipendenze:

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

Utilizzo:

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

Estrai e installa tramite Composer:

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

Utilizzo:

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

Generazione dell'SDK

Se hai bisogno di un SDK per un linguaggio diverso, puoi generarne uno tu stesso:

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

Consulta la documentazione di OpenAPI Generator per un elenco completo dei generatori disponibili.

Passi Successivi

• Per Iniziare - Guida rapida
• Autenticazione - Configurazione della chiave API
• Riferimento API - Documentazione completa degli endpoint