Crie com a API Astrológica AstroWay

Início rápido

Obtenha o horóscopo diário sem chave de API:

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

Registre uma chave gratuita

Obter chave gratuita - 10K créditos/mês, sem cartão

Primeira solicitação com sua chave

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"

Consulte taxas para limites de taxas e custo de créditos por endpoint.

Autenticação

Três tarifas. Escolha a sua.

Vinculação a domínio

As chaves pagas são vinculadas a um único domínio na primeira solicitação. É possível alterá-lo manualmente na área de usuário, até 3 vezes por mês. A instalação do plugin do WordPress envia automaticamente o cabeçalho X-AstroWay-Site-URL - sem necessidade de modificar o código.

Tratamento de erros

• 401 — X-Api-Key ausente ou inválido
• 402 — a tarifa não inclui este endpoint (por exemplo, endpoint HD sem o Pacote HD)
• 403 — inconsistência de domínio (domínio vinculado ≠ cabeçalho Origin)
• 429 — limite de solicitações excedido ou créditos mensais esgotados (cabeçalho Retry-After definido)

Widgets Embutidos

Iframe Direto - funciona em qualquer site HTML, sem carregador JS. Tarifa anônima, 30 solicitações/hora por IP do visitante.

Horóscopo diário

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

Roda do Mapa Natal

<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 do Dia do Tarô

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

Fase da Lua

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

Instalação no WordPress

Instale plugin AstroWay para WP ↗ - widgets de Tier 1 sem configurações, shortcodes para copiar, chave de API opcional para Tier 2/3.

SDK Oficiais

Três SDK próprios. Totalmente tipados, gerados com OpenAPI 3.1. Licença MIT. Com repetições de tentativas, idempotentes.

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

Site em WordPress? O plugin gratuito AstroWay для WordPress ↗ adiciona mapas natais, horóscopos, Tarô, numerologia e Human Design por meio de shortcodes e blocos do Gutenberg - sem código. Funciona de forma anônima ou com a sua chave de API.

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

LLM / Agentes de IA

Publicamos /llms.txt ↗ para detecção por agentes de IA. A família de endpoints /v1/context/* retorna XML otimizado para LLM para consumo direto por integrações com ChatGPT / Claude / Gemini.

Servidor MCP (Pro+)

Servidor nativo do Model Context Protocol em mcp.astroway.info - conecte o Claude Desktop ou qualquer cliente MCP para consultar toda a API em modo interativo. Incluído nos planos Pro e Business.