AstroWay/api v2.254.12 · el
όλες οι υπηρεσίες λειτουργούν κανονικά

// sdk · επίσημοι πελάτες

SDK για TypeScript, Python, PHP, Go, C# / .NET.

Επίσημοι πελάτες με πλήρη τυποποίηση, retry-logic, intelligent rate-limiting. Αίτημα σε 4 γραμμές κώδικα - χωρίς χειροκίνητη εργασία με cURL και headers. Υπό ανάπτυξη: Ruby, Rust. Όλοι δημιουργούνται από OpenAPI 3.1.

Δημοσιευμένα

// συντηρούνται από AstroWay · συγχρονισμός OpenAPI την ίδια ημέρα
mcp-hosted διαθέσιμο

Φιλοξενούμενο MCP - χωρίς εγκατάσταση για Claude Web / Desktop / Cursor

Φιλοξενούμενη HTTP τελική διεύθυνση μέσω mcp.astroway.info/mcp - ίδια συλλογή εργαλείων 700+ όπως το πακέτο npm, χωρίς τοπική εγκατάσταση. Μία διεύθυνση URL, ένα κεφαλίδα Bearer, και ο πελάτης σου AI βλέπει ολόκληρο το οικοσύστημα AstroWay. Πολυ-ενοικιαστής: οι πιστώσεις αντλούνται από τον λογαριασμό που κατέχει το κλειδί Bearer σου.

https://mcp.astroway.info/mcp διάβασε τον οδηγό SDK →
mcp διαθέσιμο

Διακομιστής MCP (stdio) για Claude / Cursor / GPT

Επίσημο @astroway/mcp: εκθέτει όλα τα 700++ endpoints API του AstroWay ως εργαλεία για AI agents. Λειτουργεί με Claude Desktop, Cursor, πελάτες GPT MCP. Λειτουργία stdio - το κλειδί σου παραμένει στη συσκευή σου, χωρίς άλματα δικτύου. Για σενάρια χωρίς εγκατάσταση χρησιμοποίησε το φιλοξενούμενο endpoint.

npx -y @astroway/mcp διάβασε τον οδηγό SDK →
typescript διαθέσιμο

SDK TypeScript για το AstroWay API

Επίσημο @astroway/sdk - λεπτή περιτύλιξη πάνω από το openapi-fetch (~6 KB runtime). Αυτοματοποίηση διαδρομών + τύποι αιτημάτων/απαντήσεων στο IDE σου για όλα τα 771+ endpoints. Ιεραρχία σφαλμάτων τύπου Stainless, ενσωματωμένη επανάληψη σε 408/409/429/5xx, OIDC + SLSA L3 προέλευση.

npm install @astroway/sdk διάβασε τον οδηγό SDK →
python διαθέσιμο

Python SDK για το AstroWay API

Επίσημο astroway στο PyPI - Astroway (sync) + AsyncAstroway (async) πάνω από httpx. Ταυτόσημη επιφάνεια - η ίδια API και στα δύο clients. Ιεραρχία σφαλμάτων τύπου Stainless, επανάληψη σε 408/409/429/5xx, PEP 561 пакέτο με τύπους. Python 3.9+, Trusted Publisher OIDC.

pip install astroway διάβασε τον οδηγό SDK →
php διαθέσιμο

PHP SDK για το AstroWay API

Επίσημο astroway/sdk στο Packagist - κατασκευασμένο με Guzzle 7 + PSR-18. PHP 8.1+ (μόνο για ανάγνωση ιδιότητες, προώθηση κατασκευαστή). Ιεραρχία σφαλμάτων τύπου Stainless, ενσωματωμένο middleware επανάληψης σε 408/409/429/5xx, δύο σχήματα αυθεντικοποίησης (X-Api-Key προεπιλογή ή Bearer).

composer require astroway/sdk διάβασε τον οδηγό SDK →
react διαθέσιμο

Συνεργάτης React για @astroway/sdk

Επίσημο @astroway/react στο npm - ένα λεπτό Stripe-στυλ wrapper πάνω από @astroway/sdk. Ο AstrowayProvider ανυψώνει τον πελάτη στο контέκστ React; τα hooks useAstroway, useAstrowayQuery, useNatalChart επιστρέφουν ένα τρίπτυχο SWR-στυλ { data, error, loading } με μηδέν εξωτερικές εξαρτήσεις. Λειτουργεί με React 18+, Next.js App Router (μέσω "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react διάβασε τον οδηγό SDK →
ui διαθέσιμο

AstroWay web components (alpha)

Τροχός γέννησης, φάση σελήνης, συμβατότητα, ταρώ και ωροσκόπιο ως απλά HTML elements για οποιοδήποτε site: ένα <script> tag από CDN, ή npm install. Τα charts σχεδιάζονται από τον ίδιο κώδικα με το API, οπότε ένας τροχός στη σελίδα σου ταιριάζει με αυτό που επιστρέφει το /v1/render. Alpha: τα ονόματα των attributes μπορεί ακόμη να αλλάξουν πριν το 1.0.

npm install @astroway/ui@alpha διάβασε τον οδηγό SDK →
symfony διαθέσιμο

Σύμπλεγμα Symfony για το AstroWay API

Επίσημο astroway/sdk-symfony στο Packagist - ένα Σύμπλεγμα πάνω από το astroway/sdk. Αυτο-εγγράφεται μέσω Symfony Flex, ρυθμίζεται μέσω του τυποποιημένου config/packages/astroway.yaml, εκθέτει μια αυτο-συνδεμένη υπηρεσία Astroway\Astroway για ένεση σε οποιοδήποτε ελεγκτή ή υπηρεσία. Συμβατό με Symfony 6.4 LTS και 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha διάβασε τον οδηγό SDK →
laravel διαθέσιμο

Laravel ServiceProvider για το AstroWay API

Επίσημο astroway/sdk-laravel στο Packagist - ένα ServiceProvider + фасάδ στο επίπεδο astroway/sdk. Αυτο-ανακαλύπτεται μέσω composer.json extra.laravel.providers, Astroway\Astroway καταχωρημένο ως singleton контейнερ, config δημοσιευμένο μέσω php artisan vendor:publish. Εισαγωγή σε controllers ή χρήση του фасάδ Astroway::post("/chart", ...). Λειτουργεί με Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha διάβασε τον οδηγό SDK →
go διαθέσιμο

Go SDK για το AstroWay API

Το επίσημο AstroWay Go module: κάθε API endpoint ως μέθοδο, όπως aw.Chart.Compute, με context σε κάθε κλήση. Οι επαναπροσπάθειες στα 408/409/429/5xx σέβονται το Retry-After, και ένα POST κρατά ένα Idempotency-Key, ώστε η επαναληπτική κλήση να μην χρεώνεται δύο φορές. Τα σφάλματα ελέγχονται με errors.Is, και η απάντηση αποκωδικοποιείται στον δικό σου τύπο. Μόνο standard library, Go 1.22+.

go get github.com/astroway/astroway-go διάβασε τον οδηγό SDK →
csharp διαθέσιμο

C# SDK για το AstroWay API

Πακέτο Astroway.Sdk: κάθε API endpoint ως async μέθοδο, όπως aw.Chart.ComputeAsync, ακυρώσιμο με CancellationToken. Επαναπροσπάθειες στα 408/409/429/5xx τηρούν το Retry-After, κάθε τύπος αποτυχίας έχει τη δική του εξαίρεση, και η απάντηση αποσυμπιέζεται στα δικά σου records. .NET Standard 2.0 και .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk διάβασε τον οδηγό SDK →

4 γραμμές μέχρι το πρώτο αίτημα

// TypeScript · το ίδιο pattern στο Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk πλήρες παράδειγμα →
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

Επόμενα

// roadmap · ειδοποίηση όταν κυκλοφορήσει

Το δικό σου wrapper

// OpenAPI 3.1 · η γλώσσα σου, οι δικές σου συμβάσεις

Δεν βρήκες τη γλώσσα σου στη λίστα μας; Όλοι οι endpoints περιγράφονται σε ένα τυποποιημένο OpenAPI 3.1 spec - δημιούργησε τον δικό σου πελάτη μέσω openapi-generator ή stainless.