AstroWay/api v2.254.12 · fr
tous les systèmes sont opérationnels

// sdk · clients officiels

SDK pour TypeScript, Python, PHP, Go, C# / .NET.

Clients officiels avec une typisation complète, une logique de retry, un rate-limiting intelligent. Une requête en 4 lignes de code - sans travail manuel avec cURL et les headers. En cours : Ruby, Rust. Tous générés à partir d'OpenAPI 3.1.

Publiés

// maintenus par AstroWay · synchronisation OpenAPI le même jour
mcp-hosted publiés

MCP hébergé - zéro installation pour Claude Web / Desktop / Cursor

Point de terminaison HTTP hébergé à mcp.astroway.info/mcp - même catalogue de plus de 700 outils que le paquet npm, sans installation locale. Une seule URL, un seul en-tête Bearer, et ton client IA accède à tout l'écosystème AstroWay. Multi-locataires : les crédits sont prélevés sur le compte qui possède ta clé Bearer.

https://mcp.astroway.info/mcp lire le guide SDK →
mcp publiés

Serveur MCP (stdio) pour Claude / Cursor / GPT

Serveur officiel @astroway/mcp : expose les 700+ endpoints de l'API AstroWay sous forme d'outils pour les agents IA. Compatible avec les clients MCP de Claude Desktop, Cursor, GPT. Mode stdio - ta clé reste sur ta machine, sans sauts réseau. Pour les scénarios sans installation, utilise plutôt l'endpoint hébergé.

npx -y @astroway/mcp lire le guide SDK →
typescript publiés

SDK TypeScript pour l'API AstroWay

Officiel @astroway/sdk - couche fine sur openapi-fetch (~6 KB de temps d'exécution). Autocomplétion de chemins + types de requête/réponse dans votre IDE pour tous les 771+ points de terminaison. Hiérarchie d'erreurs en style Stainless, retry intégré pour 408/409/429/5xx, OIDC + SLSA L3 provenance.

npm install @astroway/sdk lire le guide SDK →
python publiés

SDK Python pour l'API AstroWay

Officiel astroway sur PyPI - Astroway (sync) + AsyncAstroway (async) sur la base de httpx. Surface identique - la même API sur les deux clients. Hiérarchie des erreurs de style Stainless, répétition en 408/409/429/5xx, package PEP 561 typé. Python 3.9+, Éditeur de confiance OIDC.

pip install astroway lire le guide SDK →
php publiés

SDK PHP pour l'API AstroWay

Officiel astroway/sdk sur Packagist - basé sur Guzzle 7 + PSR-18. PHP 8.1+ (propriétés en lecture seule, promotion du constructeur). Hiérarchie des erreurs de style Stainless, middleware de retry intégré pour 408/409/429/5xx, deux schémas d'authentification (X-Api-Key par défaut ou Bearer).

composer require astroway/sdk lire le guide SDK →
react publiés

Compagnon React pour @astroway/sdk

Officiel @astroway/react sur npm - une couche fine dans le style Stripe sur @astroway/sdk. AstrowayProvider élève le client dans le contexte React ; les hooks useAstroway, useAstrowayQuery, useNatalChart retournent un triple { data, error, loading } dans le style SWR avec zéro dépendances externes. Fonctionne avec React 18+, Next.js App Router (via "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react lire le guide SDK →
ui publiés

AstroWay composants web (alpha)

Roue natale, phase de lune, compatibilité, tarot et horoscope sous forme d’éléments HTML simples pour n’importe quel site : une balise <script> depuis un CDN, ou npm install. Les graphiques sont générés par le même code que l’API, donc une roue sur ta page correspond à ce que renvoie /v1/render. Alpha : les noms d’attributs peuvent encore changer avant la 1.0.

npm install @astroway/ui@alpha lire le guide SDK →
symfony publiés

Bundle Symfony pour l'API AstroWay

Officiel astroway/sdk-symfony sur Packagist - un bundle basé sur astroway/sdk. Enregistrement automatique via Symfony Flex, configuré via le standard config/packages/astroway.yaml, expose un service Astroway\Astroway autowirable pour injection dans n'importe quel contrôleur ou service. Compatibile avec Symfony 6.4 LTS et 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha lire le guide SDK →
laravel publiés

Fournisseur de services Laravel pour l'API AstroWay

Officiel astroway/sdk-laravel sur Packagist - un fournisseur de services + façade sur astroway/sdk. Détecté automatiquement via composer.json extra.laravel.providers, Astroway\Astroway enregistré comme un singleton de conteneur, configuration publiée via php artisan vendor:publish. Injecter dans les contrôleurs ou utiliser la façade Astroway::post("/chart", ...) . Fonctionne avec Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha lire le guide SDK →
go publiés

SDK Go pour l'API AstroWay

Le module officiel AstroWay Go : chaque endpoint de l'API comme méthode, par ex. aw.Chart.Compute, avec un context sur chaque appel. Les retries sur 408/409/429/5xx respectent Retry-After, et un POST conserve un Idempotency-Key, donc un appel relancé n’est pas facturé deux fois. Les erreurs sont testées avec errors.Is, et la réponse est décodée dans ton propre type. Bibliothèque standard uniquement, Go 1.22+.

go get github.com/astroway/astroway-go lire le guide SDK →
csharp publiés

SDK C# pour l'API AstroWay

Package Astroway.Sdk: chaque endpoint de l'API comme méthode async, par exemple aw.Chart.ComputeAsync, annulable avec un CancellationToken. Les nouvelles tentatives sur 408/409/429/5xx respectent Retry-After, chaque type d’échec a sa propre exception, et la réponse se désérialise dans tes propres records. .NET Standard 2.0 et .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk lire le guide SDK →

4 lignes pour la première requête

// TypeScript · le même modèle en Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk exemple complet →
import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant);  // 212.0952574979425

Bientôt

// feuille de route · nous t'aviserons lors de la sortie

Ta propre enveloppe

// OpenAPI 3.1 · ta langue, tes conventions

Tu n'as pas trouvé ta langue dans notre liste ? Tous les endpoints sont décrits dans le spec OpenAPI 3.1 standard - génère ton propre client via openapi-generator ou stainless.