Τεκμηρίωση AstroWay API
Το κέντρο της τεχνικής τεκμηρίωσης του AstroWay API. 865 endpoints βασισμένα στο Swiss Ephemeris, OpenAPI spec αναγνώσιμο από μηχανές, έτοιμες συλλογές για Postman και Insomnia, επίσημα SDK για TypeScript, Python και PHP, MCP server για Claude/Cursor.
Reference
Ενότητα με τίτλο «Reference» API Reference Πλήρης κατάλογος 865 endpoints: παράμετροι, schemas απαντήσεων, κωδικοί σφαλμάτων. Παράγεται από το OpenAPI spec σε κάθε έκδοση.
OpenAPI specification Spec αναγνώσιμο από μηχανές. Κάνε import στο Postman/Insomnia ή δημιούργησε το δικό σου SDK με το openapi-generator.
Postman collection Συλλογή έτοιμη για import, με παραδείγματα για κάθε endpoint.
Per-endpoint cost Κόστος σε credits για κάθε endpoint, από 0 έως 500 credits.
Ξεκίνημα
Ενότητα με τίτλο «Ξεκίνημα» Γρήγορη εκκίνηση Εγγραφή, λήψη key και πρώτη κλήση σε 5 λεπτά.
Αυθεντικοποίηση X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT για το dashboard.
Credits και όρια Pooling των credits, μηνιαίες ποσοστώσεις, rate limits ανά πλάνο.
Υποστήριξη γλωσσών 21 ενεργές γλώσσες. Τοπικοποίηση απαντήσεων μέσω `Accept-Language` (περιεχόμενο κειμένου).
SDK και ενσωματώσεις
Ενότητα με τίτλο «SDK και ενσωματώσεις» TypeScript SDK Επίσημο πακέτο `@astroway/sdk` στο npm. ESM, Node 20+, συμβατό με browser.
Python SDK Επίσημο πακέτο `astroway` στο PyPI. Sync και async clients, Python 3.9+.
PHP SDK Επίσημο πακέτο `astroway/sdk` στο Packagist. PSR-18 HTTP, PHP 8.1+.
MCP server `@astroway/mcp`: server Model Context Protocol για Claude Desktop, Cursor και άλλους AI agents.
Μηχανική
Ενότητα με τίτλο «Μηχανική» Ακρίβεια υπολογισμών Ακρίβεια δευτερολέπτου τόξου με Swiss Ephemeris. CI snapshot tests έναντι του NASA Eclipse Catalog.
Σφάλματα Λίστα error codes, HTTP status και δομή του error envelope.
Idempotency Header `Idempotency-Key` για ασφαλές retry σε POST.
Εκδόσεις Πώς αυξάνουμε τις εκδόσεις, τι σπάει τη συμβατότητα, πώς διαβάζεται το changelog.
Σενάρια και παραδείγματα
Ενότητα με τίτλο «Σενάρια και παραδείγματα» Επισκόπηση προϊόντων Τέσσερις ομάδες προϊόντων: Birth Chart, Human Design, Synastry, Horoscope.
Βεδική αστρολογία 354+ endpoints για Vedic: Vargas, dashas (8 συστήματα), Panchang, Shadbala, Yogas, Doshas.
Παραδείγματα κώδικα Έτοιμα snippets για γενέθλιο χάρτη, συναστρία, διελεύσεις, Human Design, MCP.
Use cases Σενάρια ενσωμάτωσης για αστρολογικές εφαρμογές, AI agents και πλατφόρμες γνωριμιών.