Documentation AstroWay API
Le hub de la documentation technique d’AstroWay API. 865 endpoints basés sur Swiss Ephemeris, une spécification OpenAPI lisible par machine, des collections prêtes pour Postman et Insomnia, des SDK officiels pour TypeScript, Python et PHP, un serveur MCP pour Claude/Cursor.
Reference
Section intitulée « Reference » API Reference Catalogue complet des 865 endpoints : paramètres, schémas de réponse, codes d'erreur. Généré depuis la spécification OpenAPI à chaque release.
OpenAPI specification Spécification lisible par machine. Importe-la dans Postman/Insomnia ou génère ton propre SDK avec openapi-generator.
Postman collection Collection prête à importer, avec des exemples pour chaque endpoint.
Per-endpoint cost Coût en crédits de chaque endpoint, de 0 à 500 crédits.
Démarrage
Section intitulée « Démarrage » Démarrage rapide S'inscrire, obtenir une clé, faire le premier appel en 5 minutes.
Authentification X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT pour le dashboard.
Crédits et limites Mutualisation des crédits, quotas mensuels, rate limits par plan.
Langues prises en charge 21 langues actives. Localisation des réponses via `Accept-Language` (contenu textuel).
SDK et intégrations
Section intitulée « SDK et intégrations » TypeScript SDK Paquet officiel `@astroway/sdk` sur npm. ESM, Node 20+, compatible navigateur.
Python SDK Paquet officiel `astroway` sur PyPI. Clients sync et async, Python 3.9+.
PHP SDK Paquet officiel `astroway/sdk` sur Packagist. HTTP PSR-18, PHP 8.1+.
MCP server `@astroway/mcp` : serveur Model Context Protocol pour Claude Desktop, Cursor et d'autres agents IA.
Ingénierie
Section intitulée « Ingénierie » Précision des calculs Précision Swiss Ephemeris à la seconde d'arc. Tests snapshot en CI contre le NASA Eclipse Catalog.
Erreurs Liste des codes d'erreur, des statuts HTTP et structure de l'enveloppe d'erreur.
Idempotency En-tête `Idempotency-Key` pour des retries sûrs sur POST.
Versionnement Comment nous incrémentons les versions, ce qui casse la compatibilité, comment lire le changelog.
Scénarios et exemples
Section intitulée « Scénarios et exemples » Vue d'ensemble des produits Quatre groupes de produits : Birth Chart, Human Design, Synastry, Horoscope.
Astrologie védique 354+ endpoints pour le védique : Vargas, dashas (8 systèmes), Panchang, Shadbala, Yogas, Doshas.
Exemples de code Snippets prêts à l'emploi pour le thème natal, la synastrie, les transits, Human Design, MCP.
Use cases Scénarios d'intégration pour les applications d'astrologie, les agents IA et les plateformes de rencontre.