Costruisci con l'API astrologico AstroWay

Guida rapida

Ricevi l'oroscopo quotidiano senza chiave API:

curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"

Registrati per una chiave gratuita

Ottieni una chiave gratuita - 10K crediti/mese, senza carta

Primo richiesta con la tua chiave

curl -G "https://api.astroway.info/v1/chart" \
  -H "X-Api-Key: aw_live_…" \
  --data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
  --data-urlencode "lat=50.45" --data-urlencode "lon=30.52"

Guarda tariffe per i limiti delle tariffe e il costo dei crediti per endpoint.

Autenticazione

Tre tariffe. Scegli la tua.

Associazione al dominio

Le chiavi a pagamento vengono associate a un unico dominio al primo request. È possibile modificarlo autonomamente nel pannello, fino a 3 volte al mese. L'installazione del plugin WordPress invia automaticamente l'intestazione X-AstroWay-Site-URL - senza modificare il codice.

Gestione degli errori

• 401 — X-Api-Key mancante o non valido
• 402 — Il piano non include questo endpoint (es. endpoint HD senza HD Pack)
• 403 — Mancata corrispondenza del dominio (dominio associato ≠ intestazione Origin)
• 429 — Limite di richieste superato o crediti mensili esauriti (intestazione Retry-After impostata)

Widget incorporati

Iframe diretto - funziona su qualsiasi sito HTML, senza caricatore JS. Tariffa anonima, 30 richieste/ora per IP del visitatore.

Oroscopo giornaliero

<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
        width="100%" height="320" loading="lazy" frameborder="0"></iframe>

Ruota del tema natale

<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
        width="600" height="600" loading="lazy" frameborder="0"></iframe>

Carta del giorno dei Tarocchi

<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
        width="400" height="500" loading="lazy" frameborder="0"></iframe>

Fase Lunare

<iframe src="https://api.astroway.info/v1/embed/moon-phase"
        width="320" height="320" loading="lazy" frameborder="0"></iframe>

Installazione su WordPress

Installa plugin AstroWay per WP ↗ - widget Tier 1 senza configurazioni, shortcode da copiare, chiave API opzionale per Tier 2/3.

SDK ufficiali

Tre SDK proprietari. Completamente tipizzati, generati da OpenAPI 3.1. Licenza MIT. Con tentativi ripetuti, idempotenti.

npm install @astroway/sdk

import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
  datetime: '1990-06-15T14:30:00+03:00',
  lat: 50.45, lon: 30.52
});

pip install astroway

from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
    datetime="1990-06-15T14:30:00+03:00",
    lat=50.45, lon=30.52,
)

composer require astroway/sdk

use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
    datetime: '1990-06-15T14:30:00+03:00',
    lat: 50.45, lon: 30.52,
);

WordPress

Sito su WordPress? Il plugin gratuito AstroWay для WordPress ↗ aggiunge mappe natali, oroscopi, Tarocchi, numerologia e Human Design tramite shortcode e blocchi Gutenberg - senza codice. Funziona in modo anonimo o con la tua chiave API.

[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]

LLM / agenti AI

Pubblicchiamo /llms.txt ↗ per il rilevamento da parte di agenti AI. La famiglia di endpoint /v1/context/* restituisce XML ottimizzato per LLM per il consumo diretto da parte delle integrazioni ChatGPT / Claude / Gemini.

MCP-server (Pro+)

Server nativo del Model Context Protocol su mcp.astroway.info - collega Claude Desktop o qualsiasi client MCP per interrogare l'intera API in modalità dialogica. Incluso nei piani Pro e Business.