# Crie com a API Astrológica AstroWay

Source: https://astroway.info/pt/developers/
Language: pt
Updated: 2026-05-28

API Astrológica · v1

700+ endpoints, três SDKs próprios, precisão Swiss Ephemeris. Tarifa anônima - comece sem chave.

[Obter chave gratuita](https://api.astroway.info/dashboard/sign-up) Início rápido 10K créditos/mês · sem cartão

## 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](https://api.astroway.info/dashboard/sign-up)

### 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](https://astroway.info/shop/) para limites de taxas e custo de créditos por endpoint.

## Autenticação

Três tarifas. Escolha a sua.

| Plano | Autenticação | Limites | Marca d'água |
| --- | --- | --- | --- |
| **Anônimo** | sem chave | apenas /v1/embed/* · 30 solicitações/hora por IP | sim |
| **Chave gratuita** | `X-Api-Key: aw_live_…` | 10 mil créditos/mês | sim |
| **Pago** | `X-Api-Key: aw_live_…` | Indie 50K / Iniciante 200K / Profissional 800K / Empresarial 3,5M | não (Pro+) |

### 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 ↗](https://wordpress.org/plugins/astroway/) - 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.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
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
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · gerado com OpenAPI 3.1

### Python

astroway · v1.1.0

```
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,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · modelos Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
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,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · cliente HTTP PSR-18 · promessas Guzzle

### WordPress

Site em WordPress? O plugin gratuito [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) 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 ↗](https://api.astroway.info/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.