Documentação da API AstroWay

Centro de documentação técnica da API AstroWay. 761 endpoints baseados no Swiss Ephemeris, especificação OpenAPI legível por máquina, coleções prontas para Postman e Insomnia, SDKs oficiais para TypeScript, Python e PHP, servidor MCP para Claude/Cursor.

Referência

Referência da API Catálogo completo de 761 endpoints: parâmetros, esquemas de resposta, códigos de erro. Gerado a partir da especificação OpenAPI em cada lançamento.

Especificação OpenAPI Especificação legível por máquina. Importe para o Postman/Insomnia ou gere seu próprio SDK através do openapi-generator.

Coleção Postman Coleção pronta para importação com exemplos para cada endpoint.

Custo por endpoint Custo em créditos para cada endpoint - de 0 a 500 créditos.

Início

Início rápido Registre-se, obtenha sua chave, faça sua primeira chamada em 5 minutos.

Autenticação X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT para o dashboard.

Créditos e limites Pool de créditos, quotas mensais, rate limits por plano.

Suporte a idiomas 21 idioma ativo. Localização das respostas através de `Accept-Language` (conteúdo de texto).

SDKs e integrações

TypeScript SDK Pacote oficial `@astroway/sdk` no npm. ESM, Node 20+, compatível com navegador.

Python SDK Pacote oficial `astroway` no PyPI. Clientes sync e async, Python 3.9+.

PHP SDK Pacote oficial `astroway/sdk` no Packagist. PSR-18 HTTP, PHP 8.1+.

Servidor MCP `@astroway/mcp` - servidor Model Context Protocol para Claude Desktop, Cursor e outros agentes de IA.

Engenharia

Precisão dos cálculos Precisão de arc-second do Swiss Ephemeris. Testes CI-snapshot contra o NASA Eclipse Catalog.

Erros Lista de error codes, status HTTP e estrutura error envelope.

Idempotência Header `Idempotency-Key` para retry seguro em POST.

Versionamento Como fazemos bump de versões, o que quebra compatibilidade, como ler o changelog.

Casos de uso e exemplos

Visão geral dos produtos Quatro grupos de produtos - Birth Chart, Human Design, Synastry, Horoscope.

Astrologia Védica 354+ endpoints para Vedic - Vargas, dashas (8 sistemas), Panchang, Shadbala, Yogas, Doshas.

Exemplos de código Snippets prontos para natal chart, synastry, transits, Human Design, MCP.

Casos de uso Cenários de integração para aplicações de astrologia, agentes de IA e plataformas de encontros.