Documentația AstroWay API
Hub-ul documentației tehnice AstroWay API. 781 de endpoint-uri bazate pe Swiss Ephemeris, o specificație OpenAPI citibilă de mașini, colecții gata făcute pentru Postman și Insomnia, SDK-uri oficiale pentru TypeScript, Python și PHP, server MCP pentru Claude/Cursor.
Reference
Section titled “Reference” API Reference Catalogul complet al celor 781 de endpoint-uri: parametri, scheme de răspuns, coduri de eroare. Generat din specificația OpenAPI la fiecare release.
OpenAPI specification Specificație citibilă de mașini. Import-o în Postman/Insomnia sau generează-ți propriul SDK cu openapi-generator.
Postman collection Colecție gata de import, cu exemple pentru fiecare endpoint.
Per-endpoint cost Costul în credite pentru fiecare endpoint, de la 0 la 500 de credite.
Start rapid Înregistrează-te, obține o cheie și fă primul apel în 5 minute.
Autentificare X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT pentru dashboard.
Credite și limite Pooling de credite, cote lunare, rate limits în funcție de plan.
Limbi acceptate 21 de limbi active. Localizarea răspunsurilor prin `Accept-Language` (conținut text).
SDK-uri și integrări
Section titled “SDK-uri și integrări” TypeScript SDK Pachetul oficial `@astroway/sdk` pe npm. ESM, Node 20+, compatibil cu browserul.
Python SDK Pachetul oficial `astroway` pe PyPI. Clienți sync și async, Python 3.9+.
PHP SDK Pachetul oficial `astroway/sdk` pe Packagist. PSR-18 HTTP, PHP 8.1+.
MCP server `@astroway/mcp`: server Model Context Protocol pentru Claude Desktop, Cursor și alți agenți AI.
Inginerie
Section titled “Inginerie” Precizia calculelor Precizie de o secundă de arc cu Swiss Ephemeris. Teste CI-snapshot contra NASA Eclipse Catalog.
Erori Lista codurilor de eroare, a statusurilor HTTP și structura error envelope.
Idempotency Header-ul `Idempotency-Key` pentru retry sigur pe POST.
Versionare Cum creștem versiunile, ce strică compatibilitatea, cum să citești changelog-ul.
Scenarii și exemple
Section titled “Scenarii și exemple” Prezentarea produselor Patru grupuri de produse: Birth Chart, Human Design, Synastry, Horoscope.
Astrologie vedică 354+ endpoint-uri pentru Vedic: Vargas, dashas (8 sisteme), Panchang, Shadbala, Yogas, Doshas.
Exemple de cod Fragmente gata făcute pentru harta natală, sinastrie, tranzite, Human Design, MCP.
Use cases Scenarii de integrare pentru aplicații de astrologie, agenți AI și platforme de dating.