Changelog what is new

Todas as alterações que afetam o código do integrador: novos endpoints, atualizações do SDK, alterações em /openapi.json, ajustes de preços em créditos, depreciações, mudanças que quebram a compatibilidade. Os mais recentes — de cima para baixo. Alterações internas do site não são registradas aqui.

O contrato da API é estável dentro de /v1/* — qualquer mudança que quebra a compatibilidade é lançada sob /v2/*, e /v1/* continua a funcionar por pelo menos 12 meses.

2026-05-16 — Endpoint de MCP hospedado disponível em mcp.astroway.info/mcp

@astroway/mcp agora está disponível em dois modos de transporte. O modo Stdio (pacote npm) permanece inalterado; foi adicionado um endpoint de MCP hospedado e transmitido para integração zero-instalação no Claude $1 (claude.ai no navegador), Claude $1, Cursor, Cline e outros clientes compatíveis com MCP.

Instalação em um clique para o Cursor — botão cursor://anysphere.cursor-deeplink/mcp/install?... na página /examples/mcp/. Claude $1 — através de + → Adicionar Conector → Personalizado (sem edição de JSON).

// Opção JSON para Cline / Continue / Windsurf
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Mesmo catálogo de 630 ferramentas + 12 prompts + 14 recursos, mesma autenticação aw_test_* / aw_live_* (no modo hospedado, através do cabeçalho Authorization: Bearer … em vez de variável de ambiente), mesmo pool de créditos. Multi-tenant por design — cada solicitação carrega sua própria chave, os créditos são deduzidos da conta do proprietário da chave. Canal em X-Astroway-Channel — mcp-http (hospedado) vs mcp (stdio) para acompanhamento de adoção.

Por que dois modos. O Stdio (npx @astroway/mcp) permanece para usuários avançados do Cursor / integradores conscientes da privacidade — a chave nunca deixa a máquina, sem hops de rede. O hospedado atende ao segmento do Claude $1 (que suporta apenas MCP remoto) e cenários de instalação zero.

Endpoint de saúde — alcançável publicamente sem autenticação:

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"2024-11-05"}

Documentação completa de ambos os modos — /examples/mcp/.

2026-05-15 — Novo endpoint GET /v1/auth/keys/me

Introspecção da chave da API. Você passa X-Api-Key — obtém o estado completo: plano, créditos, status, domínio vinculado, data de criação, fonte de registro. Útil para consumidores de SDK (TS / Python / PHP / MCP) — “o que está acontecendo com minha chave agora” sem ler o painel.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # primeiros 11 caracteres, chave completa nunca é retornada
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # fim do mês do calendário
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # domínio ao qual a chave está vinculada (chaves do plugin do WordPress)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Sem autenticação: 401 MISSING_API_KEY. Chave inválida: 401 INVALID_API_KEY.

Especificação OpenAPI 3.1. /v1/openapi.json agora declara /v1/auth/keys/me. O código do SDK será gerado automaticamente (openapi-typescript, openapi-generator-cli) durante a próxima regeneração.

Compatibilidade reversa. O antigo GET /v1/keys/usage (que retornava apenas credits_today + rate limit) continua a funcionar — é um endpoint separado para verificações de cron no servidor. /auth/keys/me retorna o estado completo mais o vinculo de domínio para cenários do plugin do WordPress.

2026-05-14 — Localização de /horoscope/* e /interpret/* (21 idiomas)

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} e POST /v1/interpret/{natal,synastry,transits,element,placement} — 10 endpoints que retornam texto de interpretação — agora retornam a resposta no idioma do cliente.

Como conectar:

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Accept-Language: hi" \
  -H "Content-Type: application/json" \
  -d '{"sign": "leo"}'
# → resposta em हिन्दी

Prioridade de resolução (lado do servidor):

1. body.language="de" — parâmetro explícito por chamada (maior prioridade)
2. Accept-Language: de, en;q=0.7 — ponderado por q (primeiro código que coincide com o idioma ativo vence)
3. ?lang=de — parâmetro de consulta para clientes que não controlam cabeçalhos
4. Fallback → uk (idioma de origem)

Idiomas suportados (21): uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Códigos desconhecidos caem silenciosamente em uk sem erros.

Especificação OpenAPI 3.1. /v1/openapi.json agora declara Accept-Language (cabeçalho) e lang (parâmetro de consulta) como parâmetros com enum de 21 códigos nesses 10 endpoints. O código do SDK (openapi-typescript, openapi-generator-cli) automaticamente adicionará chamadas tipadas .lang('hi') durante a próxima regeneração.

O que é traduzido: apenas campos de texto de interpretação (horoscope, interpretation, disclaimer, etc.). Campos numéricos (longitude, latitude, score, IDs de signos, IDs de casas) permanecem canônicos — o cliente formata localmente. Padrão de segmento (Vedika, DivineAPI, AstrologyAPI.com).

Escopo: atualmente, 10 endpoints do grupo de interpretação são localizados. Endpoints de cálculo (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 outros) retornam números e IDs canônicos (name: "Aries", glyph: "♈") inalterados — o cliente localiza-os por meio de suas tabelas de lookup. Este é o padrão de segmento.

Compatibilidade reversa. O código existente sem Accept-Language / ?lang= / body.language recebe uk como padrão, como antes.

Suporte ao SDK (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) adiciona a opção lang no construtor — lançamentos separados chegam nas próximas semanas por meio de um aplicador de cron em repositórios de pré-lançamento.

2026-05-09 — Três SDKs lançados: TypeScript, Python, PHP

Três SDKs oficiais vivem em repositórios públicos — wrappers em torno dos mesmos 700+ endpoints da API. Uma especificação OpenAPI 3.1 → três clientes idiomáticos de linguagem.

O que isso significa para o integrador:

• Alternativa de tipo seguro ao HTTP bruto. Autocompletar de caminho + tipos de solicitações e respostas no IDE. Métodos de ajuda aw.post('/chart', body=...) (Python/PHP) ou aw.client.POST('/chart', { body }) (TS) — em vez de fetch / requests / Guzzle manuais.
• Superfície idêntica em diferentes linguagens. Construtor Astroway({apiKey, baseUrl, authScheme, timeout, retry}) funciona da mesma forma em TS / Python / PHP. Se o projeto for multilíngue — menos sobrecarga cognitiva.
• Repetição incorporada em 408/409/429/5xx com backoff exponencial + jitter completo. Honra o cabeçalho Retry-After. Padrão 2 repetições, configurável por meio de retry={maxRetries: 0}.
• Hierarquia de erros inoxidável — mesmo padrão que nos SDKs da Stripe / OpenAI / Cloudflare. Capture RateLimitError (com retryAfterSeconds), AuthenticationError (girar chave), BadRequestError (validação), ApiError (genérico) — nessa ordem.
• Dois esquemas de autenticação. Padrão X-Api-Key: aw_live_... (como em curl/Postman). Ou Authorization: Bearer aw_live_... (como nos SDKs da Stripe/OpenAI/Anthropic) — auth_scheme="bearer" no construtor.
• Cabeçalhos de identificação, sem telemetria. Cada solicitação carrega User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. Sem phone-home, sem interruptor de opt-in/opt-out.
• OIDC + SLSA L3 provenance (TS + Python). Registro atestado por Sigstore que o pacote foi construído a partir de um commit específico no repositório público. Sem tokens de longa duração no CI.
• MIT, código-fonte aberto em github.com/astroway/{astroway-typescript,astroway-python,astroway-php}.

Início rápido:

// TypeScript / Node 20+
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data } = await aw.client.POST('/chart', { body: { date: '1990-07-14', /* ... */ } });

# Python 3.9+
from astroway import Astroway
aw = Astroway(api_key=os.environ['ASTROWAY_API_KEY'])
chart = aw.post('/chart', body={'date': '1990-07-14', ...})

// PHP 8.1+
use Astroway\Astroway;
$aw = new Astroway(['apiKey' => getenv('ASTROWAY_API_KEY')]);
$chart = $aw->post('/chart', body: ['date' => '1990-07-14', /* ... */]);

Variante assíncrona para Python — AsyncAstroway com superfície idêntica por meio de async/await. Em PHP — somente síncrono (PHP não tem uma história unificada de assincronismo). Em TS — promessas nativas com base em openapi-fetch.

Isso é alpha — a API pública pode mudar até 0.1.0 apropriada com base no feedback dos integradores. Fixe a versão exata (@astroway/sdk@0.1.0-alpha.1) durante a janela alpha — ou a última alpha no momento da instalação.

@astroway/mcp — servidor MCP para Claude / Cursor / GPT — continua a existir como um produto separado.

2026-05-07 — Atualização do servidor MCP

@astroway/mcp foi atualizado — gera automaticamente o catálogo de ferramentas a partir do /openapi.json atual sem edição manual. Tudo o que foi adicionado à API nas últimas semanas (conjunto de compatibilidade, endpoints de relatórios) está imediatamente visível no Claude / Cursor / GPT.

Para o integrador:

• O catálogo de ferramentas reflete o estado atual da API
• Endpoints de modelo de caminho (/v1/.../id) são pulados por enquanto para não confundir o analisador de descrição
• Anotações de custo em ferramentas de descrição — o Claude vê o custo da chamada antes da execução
• Publicação OIDC confiável + Provenance SLSA L3 — o pacote é atestado até um commit específico no repositório público astroway/astroway-mcp

Instalação:

npm install -g @astroway/mcp

Ou através da configuração do MCP do Claude $1 / Cursor:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"]
    }
  }
}

Código-fonte: repositório público astroway/astroway-mcp (MIT).

2026-04-11 — Compatibilidade entre sistemas (+10 endpoints)

Novo grupo /v1/compat/* — pontuação de compatibilidade composta em todo o ocidente, védico, chinês, numerologia, tarô, design humano. 6 sistemas fornecem uma métrica unificada para indicadores de UX em aplicativos astrológicos multitracionais.

Cada endpoint retorna um JSON com um campo disclaimer — essa é a metodologia de pontuação da AstroWay, não uma afirmação clínica ou jurídica. Nível 4 (100 créditos) por chamada — computação de sistema cruzado pesado.

Manifesto em /openapi.json atualizado — SDK / MCP pegarão automaticamente.

2026-03-28 — Relatórios + Webhooks (+17 endpoints)

Dois novos grupos em produção.

/v1/reports/* (12 endpoints) — geração de relatórios HTML / PDF por meio do Puppeteer. Renderização no lado do servidor de cálculo, URL de download assinado (TTL 24h).

/v1/webhooks/* (5 endpoints) — gerenciamento de assinatura, entrega de eventos, assinatura HMAC. Assinatura de eventos credits.low, key.created, usage.threshold, error.spike.

curl -X POST https://api.astroway.info/v1/webhooks \
  -H "Authorization: Bearer aw_live_..." \
  -d '{"url": "https://...", "events": ["credits.low"], "secret": "wh_secret_..."}'

Cada entrega carrega X-Astroway-Signature: sha256=<hmac> — verifique por meio de secret. Política de repetição: backoff exponencial em 5xx, até 5 tentativas em 24 horas.

2026-03-14 — Endpoints de referência: públicos, sem chave, sem créditos

14 endpoints /v1/reference/* (signos, planetas, casas, aspectos, elementos, modalidades, polaridades, dignidades, decanatos, nakshatras, partes, asteroides, sistemas zodiacais, glifos) agora funcionam sem X-Api-Key e custam 0 créditos. Esses são tabelas de lookup canônicas — cobrar por elas por meio de cobrança foi um erro de projeto.

O que isso significa para o integrador:

• Chamada sem chave — agentes MCP / SDK / pré-visualizações de página externos podem puxar dados de referência sem autenticação. O rate limit de IP (30 solicitações / hora) permanece.
• Manifesto de custo atualizado — 14 caminhos mudaram de TIER_HALF (5 créditos) para 0. Se o seu orçamento do plano astroway_cost_estimate se refere a esses caminhos — as novas chamadas não afetam a cota.
• Clientes existentes com chave funcionam sem alterações. X-Api-Key é ignorado para /reference/* (não nos importamos com o cabeçalho extra).

Compatibilidade reversa: respostas 200 e esquema JSON não mudam, apenas o requisito de autenticação é removido.

2026-03-07 — Oferta de fundadores: $299 → plano Indie por toda a vida

Lançamos a Oferta de Fundadores — lançamento limitado. Os primeiros 100 clientes pagam $299 única vez e recebem o plano Indie (50.000 créditos/mês) por toda a vida, sem cobranças recorrentes, com preço fixo.

O que isso significa para os integradores:

• Plano Indie padrão = $5/mês. Oferta de Fundadores = única vez $299 → ponto de retorno no 5º ano, depois disso, ROI ilimitado. Se o seu projeto durar pelo menos 5 anos em astrologia / numerologia / Tarô — a Oferta de Fundadores se paga.
• Payload de webhook no checkout SKU astroway-api-indie-lifetime: a string api_keys recebe plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Sem cobranças mensais, sem webhooks de renovação.
• Esquema de banco de dados: adicionadas colunas is_lifetime TINYINT(1) em api_keys e shared_user_quotas. Tipo TS ApiKeyInfo expandido. Chaves existentes = is_lifetime=0 (sem alteração de comportamento).
• Endpoint REST do WordPress GET /wp-json/astroway/v1/founders-count retorna {sold, total: 100, remaining, available} — usado em site/components/founders/FoundersCounter.astro para o contador em tempo real na página /founders/.
• Desativação automática em 100/100: _stock_status do produto WC muda automaticamente para outofstock por meio do hook WC woocommerce_order_status_completed. Depois disso, o link de checkout redireciona para /pricing/#indie (plano Indie padrão $5/mês).

Páginas ao vivo: /founders/ (uk) + /en/founders/ (en). Entrada lateral “Oferta de Fundadores” com badge de 100 apenas 🚀.

Produto do WordPress: astroway-api-indie-lifetime, ID 30618, $299 (13225 UAH), estoque=100. Checkout: astroway.info/checkout/?add-to-cart=30618.

2026-03-05 — Página de aterrissagem GDPR / residência da UE + cartão Pro UE

Lançamos /eu/ — página separada para desenvolvedores da UE cujo produto é sensível ao GDPR. O integrador precisa saber:

• Pro $59 = residência da UE por padrão (Hetzner Nuremberg, fluxo de dados apenas dentro da UE, análise anônima — Plausible cookie-free no roadmap).
• DPA padrão disponível não apenas na Empresa — assinado por meio de e-mail no plano Pro padrão em 5 dias úteis.
• DELETE /v1/me/account — endpoint para o direito de exclusão do GDPR (exclui imediatamente o wp_user_id de todas as tabelas).
• Cartão Pro em /pricing/ agora tem um ícone 🇪🇺 GDPR-ready — clique leva a /eu/ com FAQ completo.
• DivineAPI / AstrologyAPI / Prokerala — hospedagem EU/Índia, DPA apenas na Empresa. Se a conformidade com o GDPR for crítica — Pro $59 é o caminho mais barato.

Páginas: /eu/ (uk) + /en/eu/ (en). Entrada no menu lateral «GDPR / residência da UE» com ícone 🇪🇺.

2026-03-03 — Pagamento anual −25% + transferência de créditos + recursos públicos Pro

Duas alterações que afetam o código do integrador:

• Desconto anual 17% → 25% (3 meses gratuitos em vez de 2). Novos preços em USD por ano: Indie $45, Starter $171, Pro $531, Business $1791, Pacote HD/Esotérico $81, Pacote Védico $171, Pacote de Relatórios $891. Assinantes de plano anual existentes não são afetados — o novo preço é aplicado apenas a renovações futuras de assinatura. Se você analisou os preços em USD por meio de /wp-json/astroway/v1/api-prices — os valores atualizados são retornados automaticamente agora.
• Transferência de créditos para assinantes anuais: créditos não utilizados são transferidos para o próximo ciclo mensal, limitados a 1 × limite mensal do plano. Ativado automaticamente ao assinar um plano anual. Visível por meio de novos cabeçalhos de resposta:
  • X-Credits-Limit: <int> — limite mensal efetivo (inclui transferência)
  • X-Credits-Remaining: <int> — como era antes, mas com transferência considerada
  • X-Credits-Rollover: <int> — saldo atual de créditos transferidos (apenas para anuais)
• Recursos Pro ($59) agora são divulgados publicamente: endpoints de transmissão (em tempo real), conformidade com o GDPR da UE, MCP expandido (multiagente / debate / RAG), webhooks (10 tipos). Esses são recursos que já estavam no Pro — anteriormente estavam escondidos na documentação.

Esquema de banco de dados: adicionadas colunas credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED em api_keys e shared_user_quotas. No início — ambos = 0 para todas as chaves existentes.

2026-03-01 — Tabela de custo de créditos transparente por endpoint

Lançamos a página pública /credits/ com a divisão completa de créditos por todos os 700+ endpoints. Nenhum concorrente (DivineAPI, AstrologyAPI, Prokerala) publica tal tabela — eles cobram um crédito fixo por chamada e escondem a rota interna.

Para o integrador, isso oferece três coisas:

• Unidade econômica transparente — custo exato em $/chamada para cada endpoint (orçamentos mensais /pricing/ × custo do plano = custo real por chamada).
• Sincronização automática com o código — a tabela é gerada durante a compilação a partir de endpoint-costs.ts. Se adicionarmos um novo endpoint ou alterarmos o plano — a página é atualizada automaticamente na próxima implantação.
• Marcador de plano gratuito — a coluna mostra quais endpoints exigem Indie+ (ícone 🔒, 28 endpoints atualmente).

Disponível: /credits/ (uk) e /en/credits/ (en). Links cruzados com /rate-limits-credits/ e entrada no menu lateral Starlight (ícone «Novo»).

2026-02-27 — Vedic-charts, cosmogram, eclipse-path, star-map (+6 endpoints)

Fecha a categoria Visualização em 14/14 endpoints no roadmap:

• POST /v1/render/wheel-vedic-north — layout norte-indiano (diamante).
• POST /v1/render/wheel-vedic-south — layout sul-indiano (grade 4×4).
• POST /v1/render/wheel-vedic-east — layout leste-indiano (quadrado com diagonais + quadrado interno invertido).
• POST /v1/render/cosmogram — cosmograma da Escola de Hamburgo / Cosmobiologia (90°-dial).
• POST /v1/render/eclipse-path — mapa do mundo em equirectangular com o caminho lat/lon fornecido pelo chamador; renderiza a linha central + faixa de largura especificada.
• POST /v1/render/star-map — projeção estereográfica da lista de pontos (RA/Dec) com escala de magnitude.

Todos os renders são puros SVG, sem headless-Chrome.

2026-02-25 — Bi-rodas + composto + biorritmo (+4 endpoints)

Quatro novos endpoints de visualização que expandem a mecânica SVG:

• POST /v1/render/bi-wheel — duas rodas concêntricas: interna natal + externa com planetas de trânsito (ou progressivos).
• POST /v1/render/tri-wheel — três rodas: natal + progressivo + de trânsito.
• POST /v1/render/composite — renderização da carta composta de dois dados de entrada natais (composto de midpoint).
• POST /v1/render/biorhythm — gráfico sinusoidal dos três ciclos: físico (23 dias), emocional (28), intelectual (33).

Cálculos aqui são próprios, apenas renderização; para bi-rodas, todos os planetas das duas cartas são calculados em paralelo (Promise.all).

2026-02-24 — Visualização: renderização SVG (+4 endpoints)

Quatro novos endpoints que retornam renders SVG de cartas natais e visualizações relacionadas. Puro servidor — sem Puppeteer/headless-Chrome, portanto atraso ~10 ms em vez de 1-2 segundos e gratuitamente para o plano gratuito.

• POST /v1/render/wheel-western — roda ocidental (anéis de signos + casas + planetas + linhas de aspecto).
• POST /v1/render/aspect-grid — matriz triangular de aspectos com sinal + orbe nas células.
• POST /v1/render/moon-phase — disco da Lua com iluminação; retorna SVG mais illuminationFraction, phase, waxing.
• POST /v1/render/timeline — estilo Gantt para eventos de trânsito por período (chamador fornece matriz events).

Opções: size, theme (light / dark / console), format (json retorna { svg, byteLength }, svg retorna image/svg+xml diretamente). Nível de cobrança básico — 2 créditos por chamada.

2026-02-23 — Esquemas tipados em /v1/openapi.json (612 endpoints, 98%)

/v1/openapi.json agora é uma especificação completa e legível por máquina para corpos de solicitação e dados de resposta. Tipados 612 dos 624 endpoints POST por meio de três etapas consecutivas que aterrissaram juntas:

• Corpos de solicitação — 386 endpoints tipados por meio de components.schemas (128 componentes reutilizáveis). Entre eles, 5 compartilhados (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) e 123 locais (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern, etc.). Composição por meio de allOf para herança (DashaInput extends ChartInput).
• Dados de resposta data — 612 endpoints tipados por meio de um inferidor que percorre os exemplos de resposta no manifesto: {type: 'object', properties: {...}} em vez de {type: 'object'} plano. A carta natal agora declara data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] com tipos de campo reais.
• Restante 12 endpoints — dasha pratyantar/sookshma com exemplos de shorthand não distinguíveis no manifesto — permanecem {type: object}. Compatibilidade reversa, adicionamos a eles nas próximas versões.

O que isso significa para o integrador:

• Regenere o cliente OpenAPI — openapi-typescript, openapi-fetch, swagger-codegen criarão interfaces com campos tipados em vez de Record<string, unknown>. Autocompletar em corpos de solicitação + dados de resposta funciona nativamente.
• Coleção do Postman em /postman/astroway-api.json foi atualizada com os mesmos tipos — importe, obtenha autocompletar para todos os endpoints tipados.

Compatibilidade reversa: a forma anterior {type: "object"} era permissiva — todos os clientes existentes continuam a funcionar sem alterações.

2026-02-21 — Revisão de preços: Relatórios unificados, Business +500K, Free reforçado

Três alterações de preços que afetam os integradores:

• Relatórios unificados em 5.000 créditos — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab reduzidos de 10.000 cr para 5.000 cr por chamada (duas vezes mais barato). Todos os relatórios em PDF agora custam o mesmo — matemática mais simples para o orçamento do pacote.
• Plano Business +500K créditos/mês — o plano Business agora fornece 3.500.000 créditos por mês (era 3.000.000) pelo mesmo preço de $199. Assinantes existentes receberão o limite aumentado automaticamente com o próximo ciclo de cobrança.
• Plano Free: /v1/reports/* exige plano pago — 12 endpoints de relatórios em PDF (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) agora retornam 402 PLAN_UPGRADE_REQUIRED para chaves Free. O restante da funcionalidade — cartas, sinastria, previsões, horóscopo — permanece disponível no plano Free.

Se a sua chave Free chamou um desses endpoints — atualize para o plano Indie ($5/mês) ou superior, ou altere para os equivalentes em JSON (/v1/chart, /v1/synastry, etc.) para conteúdo semelhante sem renderização em PDF.

2026-02-19 — Autenticação via Google e GitHub (+2 endpoints)

Um conta para toda a ecossistema — o usuário que se registrou no astroway.info ou app.astroway.info entra no console do desenvolvedor por meio do mesmo e-mail/SSO, vê o histórico de pedidos, créditos e chaves da API.

• GET /v1/auth/oauth/google/start?return=<path> — inicia o fluxo de autenticação do Google.
• GET /v1/auth/oauth/github/start?return=<path> — inicia o fluxo de autenticação do GitHub.

Callback é concluído com um redirecionamento para /dashboard/oauth/callback#access_token=&refresh_token=&user= — em seguida, o painel persiste os tokens como após /v1/auth/login. Se o e-mail já estiver registrado por meio de um formulário regular e email_verified=true do provedor — a conta é vinculada, uma nova não é criada.

2026-02-17 — Pacote de relatórios ($99 / 500.000 créditos) + white-label incluído

Plano para desenvolvedores de relatórios em PDF — 100 PDF/mês por $0,99 efetivamente, com white-label por padrão:

• Plano reports_pack ($99/mês ou $990/ano) fornece 500.000 créditos e 200 solicitações/hora.
• Acesso limitado a /reports/* (12 tipos de relatórios em PDF: natal, sinastria, filho, negócios, carreira, amor, dinheiro, trânsito anual, kundli védico, lal kitáb, design humano, tarô) + /whitelabel/* (logotipo personalizado + cores + domínio). Todos os outros endpoints retornam 402 PLAN_PACK_MISMATCH.
• White-label incluído como padrão — não é necessário atualizar para a Empresa para PDFs personalizados.
• Sobrecarga de $3 / 10.000 créditos (como no Pro), interruptor de limite de gastos disponível.
• 21 localizações de PDF, formato A4, entrega por meio de URL assinada do CDN (TTL 24 horas).

API plan enum agora: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. Novo slug do WC: astroway-api-reports-pack.

2026-02-15 — Kros-escrita: Jaimini yogas + Lal Kitab e KP doshas (+17 endpoints)

Dezessete endpoints — fecham a vertical da kros-escrita para yogas e doshas.

• Jaimini Yogas (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Baseado em chara karakas (AK / Amk / PK).
• Lal Kitab dosha variantes (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. Variações e upayas específicas do Lal Kitab.
• KP dosha variantes (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. Regras do BPHS + cadeia de sub-senhores do KP. Sade Sati — consciente de trânsito (exige targetDate).

Fontes: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI. Preço: Nível 3 (50 créditos).

2026-02-13 — Pacote Védico ($19 / 100.000 créditos)

Plano separado para a astrologia védica — 165 endpoints pelo preço do plano Starter:

• Plano vedic_pack ($19/mês ou $190/ano) fornece 100.000 créditos e 100 solicitações/hora.
• Acesso limitado a namespaces védicos (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Todos os outros endpoints retornam 402 PLAN_PACK_MISMATCH.
• Cobertura: 16 vargas D1-D60, panchang (7), shadbala (7), yogas (7), doshas (7), compatibilidade ashtakoot (6), muhurat (12 categorias), 8 sistemas dasha × 5 níveis (40), KP, Lal Kitab, Jaimini.
• 2,5-5 × mais cartas pelo mesmo preço que o Prokerala Ruby (~5K kundlis/mês vs 1-2K deles).

API plan enum agora: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Novo slug do WC: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: pacote completo (+12 endpoints)

Doze endpoints da escola védica norte-indiana baseada em MSS anônimos em urdu 1939-1952. A escola completa — AMARELO (intrínseca — única escola com divergências entre autores modernos).

• /vedic/lal-kitab/teva — carta de casa fixa (casa = signo).
• /vedic/lal-kitab/lal-kundali — layout de grade 4×4.
• /vedic/lal-kitab/kismat + /prosperity — pontuação de fortuna e yoga de dhana.
• /vedic/lal-kitab/dasha (35 anos) + /varshphal + /life-graph — temporização.
• /vedic/lal-kitab/debts — detecção de 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) + remédio.
• /vedic/lal-kitab/remedies — upayas por planeta (dia / mantra / doação).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Disclaimer visível nas respostas. Fontes: K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Pacote Esotérico ($9 / 200.000 créditos)

Novo plano adicional para desenvolvedores de esoterismo/divinação — 180 endpoints por $9/mês:

• Plano esoteric_pack ($9/mês ou $90/ano) fornece 200.000 créditos e 60 solicitações/hora.
• Acesso limitado a espaços esotéricos/divinação (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Todos os outros endpoints retornam 402 PLAN_PACK_MISMATCH.
• Não combinado com outros planos na mesma chave — este é uma extensão separada, semelhante ao Pacote HD.

API plan enum agora: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Novos slugs do WC: astroway-api-esoteric-pack (variações mensais + anuais). Se você criou chaves por meio de /v1/keys sem plano explícito — nada muda.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 endpoints)

Terceira categoria chinesa, após o Zodíaco Chinês + Feng Shui:

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Pilar do ano + pilar do mês canônicos, pilar do dia + pilar da hora adiados até a verificação cruzada com o Observatório de Hong Kong (diferentes fontes dão diferentes âncoras JD).
• Zi Wei Dou Shu MVP (12) — /ziwei/{twelve-palaces, main-stars, full-chart, palace-destiny, palace-siblings, palace-spouse, palace-children, palace-wealth, palace-health, palace-travel, palace-career, palace-property}. MVP — significados de palácio + lista de 14 estrelas principais. Carta completa adiada (é necessária uma efeméride lunar mensal especializada).

API agora expõe 505 endpoints — paridade com o concorrente mais amplo (Astrology-API.io).

2026-01-30 — Bem-estar (+9 endpoints)

Nove endpoints de bem-estar — astrologia médica + dieta + ioga + cristais, etc. Uso educacional apenas — não é conselho médico, disclaimer em cada resposta.

• POST /v1/wellness/medical-astrology — governança corporal por meio da astrologia tradicional de Melothesia.
• POST /v1/wellness/diet — alimentos por elemento (foco / enfatize / evite).
• POST /v1/wellness/yoga — foco + posturas + pranayama por signo.
• POST /v1/wellness/exercise — intensidade + recomendado/evite por elemento.
• POST /v1/wellness/mental-health — perfil de elemento espelhado + elemento dominante + forças/fracos + coping.
• POST /v1/wellness/sleep-cycles — dicas de sono por fases da Lua.
• POST /v1/wellness/herbs — ervas por governante planetário do signo (Culpeper 1653).
• POST /v1/wellness/crystals — cristais por signo + intenções.
• POST /v1/wellness/cycle — marcos de bem-estar baseados na idade (retorno de Saturno, oposição de Urano, …).

Fontes: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Nível — 2 créditos (ciclo = 1 crédito).

2026-01-27 — Calendários maias (+8 endpoints)

Bloco maia: calendário sagrado Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night, mais Dreamspell (moderno Argüelles 1990).

• POST /v1/mayan/tzolkin — calendário sagrado de 260 dias (número 1-13 + nome de 20).
• POST /v1/mayan/haab — calendário civil de 365 dias (18 meses × 20 + 5 dias Wayeb).
• POST /v1/mayan/long-count — notação posicional de 5 lugares baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round — calendário combinado Tzolkin+Haab (ciclo de 52 anos).
• POST /v1/mayan/lord-of-night — ciclo de 9 dias (G1-G9).
• POST /v1/mayan/full — tudo o que é clássico em uma chamada.
• POST /v1/mayan/compatibility — compatibilidade do par por tom/nome/elemento/direção.
• POST /v1/mayan/dreamspell — sistema moderno de Argüelles (kin 1-260, tom × selo).

Fonte: correlação Goodman-Martínez-Thompson (Thompson 1935 + Lounsbury 1976). Validação âncora: 2012-12-21 = Long Count 13.0.0.0.0 ✓ (rolagem do Baktun).

2026-01-23 — Sthira + Shoola Dasha (+10 endpoints)

Duas escolas Jaimini de rasi-dasha com cascata completa:

• Sthira — direção = para a frente para signos móveis/duplos da laguna, reverso — para signos fixos.
• Shoola — semente = stronger_rasi(asc, asc+6), direção = para a frente 12×9 anos, opção antardasaSeedOption ∈ 3.

Fecha o conjunto de 10 escolas dasha × 5 níveis = 50 endpoints. Fontes: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Pet + Negócios + Financeiro (+36 endpoints)

Três categorias em um único envio:

• Pet (14) — /pet/{birth-chart, sun-sign-meaning, personality, temperament, training-style, diet-by-sign, grooming-by-element, exercise-needs, communication-style, play-style, health-tips, best-names, lucky-day, owner-pet-compatibility}. Disclaimer: entretenimento apenas — não é cuidado veterinário.
• Negócios (12) — /business/{founder-personality, leadership-style, ideal-industry, founding-chart, electional-day, name-suggestions, team-compatibility, customer-archetype, marketing-style, risk-profile, ideal-partner-sign, expansion-timing}. Disclaimer: ideação estratégica, não é aconselhamento jurídico/tributário.
• Financeiro (10) — /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ NÃO É CONSELHO DE INVESTIMENTO — disclaimer reforçado em cada resposta.

Nível — 2 créditos (Market Timing/Wealth Cycle do Financeiro = 3 créditos).

2026-01-16 — Suíte de análise Jaimini (+10 endpoints)

Dez endpoints de análise Jaimini:

• Chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK em D9), resumo de dasha em execução, yogas Jaimini básicos.

Fontes: Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-01-09 — Página de status + agentes de IA + URL base padrão

• Página de status pública: https://api.astroway.info/status — tempo de atividade, latência p50/p95/p99, cache de 60s.
• llms.txt para agentes de IA: https://api.astroway.info/llms.txt — instruções estruturadas para agentes Claude / ChatGPT / Perplexity Code.
• URL base padrão na documentação, servidor MCP, SDKs, coleção do Postman — api.astroway.info/v1 (com redirecionamento 301 do antigo api-calc.astroway.info).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashas (+15 endpoints)

Três sistemas de dasha nakshatra com cascata completa:

• Tribhagi — escala 1/3 do Vimshottari (ciclo de 40 anos).
• Shatabdika — ciclo de 100 anos, 7 planetas (sem sombra).
• Shodashottari — ciclo de 116 anos, 8 planetas (sem Rahu).

Fontes: BPHS Adhyaya 46.

2025-12-25 — Compatibilidade védica + Muhurat (+18 endpoints)

• Compatibilidade (6) — combinação Ashta-Koota (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + compatibilidade de Mangal dosha + resumo de Bhrigu.
• Muhurat (12) — eleição para casamento, negócios, viagem, educação, cirurgia, noivo, tipos de muhurat.

Fontes: BPHS + Muhurta Chintamani.

2025-12-02 — Vedic Vargas D1-D60 + Panchang + Shadbala (+31 endpoint)

• 16 Vargas D1-D60 (16) — desde Rasi (D1) até Shashtiamsa (D60), por BPHS Adhyaya 7.
• Panchang (8) — tithi, vara, nakshatra, yoga, karana + sunrise/sunset, abhijit, rahu kaal.
• Shadbala (7) — 6 fontes de força por planeta + composto (Sthana, Dig, Kala, Cheshta, Naisargika, Drig).

2025-08-10 — Dicionários esotéricos + Cristal/Anjo/Sonho (+30 endpoints)

Expansão de dicionários de referência: 15 conceitos esotéricos (chakras, koshas, tattvas, gunas) + 15 tabelas de lookup de cristal/anjo/sonho. Cache em edge (Cloudflare R2).

2025-03-12 — Glossário de referência + Tarô Lenormand (+24 endpoints)

• Referência (14) — dicionários de signos, planetas, casas, aspectos, nakshatras, estrelas fixas, símbolos sabianos.
• Tarô Lenormand (10) — sistema de 36 cartas: único, 3 cartas, 9 cartas, Grand Tableau, por pergunta.

2024-11-15 — Tarô de Marselha (+20 endpoints)

Vinte endpoints do baralho de Marselha: espalhamentos (único, 3 cartas, Cruz, 5 cartas, Cruz Celta, ano à frente), significados de cartas, modo reverso, por pergunta. Fontes: referências públicas de Camoin / Jodorowsky.

2024-08-25 — Numerologia — pacote completo: Pitagórico + Caldeu + Cabalístico + Védico (+40 endpoints)

Quatro sistemas de numerologia × 10 endpoints cada: caminho de vida, expressão, impulso da alma, personalidade, aniversário, maturidade, ano pessoal atual/mês/dia, compatibilidade de nome.

Fontes: Pitagórico (Cheiro 1908), Caldeu (Cheiro), Cabalístico gematria hebraica, Védico Caldeu Indiano.

2024-05-08 — Tarô Rider-Waite-Smith (+35 endpoints)

Trinta e cinco endpoints do baralho RWS: todos os espalhamentos canônicos (único, 3 cartas, Cruz Celta, ano à frente, relacionamento, 5 cartas em ferradura, 7 cartas em elipse, decisão, situação, mensal), significados de cartas (direito + reverso), por pergunta, cartão diário, embaralhamento do baralho.

Fontes: imagens de Smith em domínio público desde 2021, Waite “Pictorial Key” 1909 em domínio público.

2024-02-20 — Geração de horóscopo de IA + interpretações (+12 endpoints)

Geração de texto de interpretação natural:

• /horoscope/{daily, weekly, monthly} — horóscopos de texto.
• /interpret/{natal, transit, synastry, compatibility} — interpretações detalhadas.

Cadeia de provedor: GPT-4 → Anthropic Claude → fallback Groq.

2023-11-28 — Matriz do Destino (Ladini) (+1 endpoint)

/destiny-matrix/ladini — sistema de Natalia Ladini (mercado russo/CIS). Método de autor único com disclaimer explícito.

2023-09-20 — Linha do tempo de aspectos + harmônicas + índice cíclico (+12 endpoints)

Análise de aspectos expandida:

• /aspect-timeline — momentos exatos de aspectos nos próximos N dias.
• /harmonics/{2..12} — cartas harmônicas.
• /cyclic-index — índice cíclico de tensões sociais de André Barbo.
• /sabian-symbols — 360 símbolos de Marc Edmund Jones.

2023-05-10 — Astrocartografia + Espaço Local + Geodético (+18 endpoints)

Geoastrologia:

• /acg + /acg-zones — linhas planetárias da Astrocartografia.
• /local-space — horizonte do Espaço Local.
• /parans — parans (Bernadette Brady).
• /relocation — carta de relocação.
• /zenith + /horizon + /geodetic — motores geo adicionais.
• /ccg-analysis — análise detalhada da CCG/CMG.

Fontes: Jim Lewis Astro*Carto*Graphy, Sepharial Theory of Geodetic Equivalents, Bernadette Brady.

2023-02-15 — Módulo de Design Humano (+12 endpoints)

Motor de Design Humano completo:

• /human-design — bodygraph (portas, canais, centros, tipo, perfil, autoridade, estratégia, ambiente, perspectiva).
• /hd/incarnation-cross — cruz da encarnação + 4 portas.
• /hd/{canais, portas, perfis, definição, autoridade, estratégia, ambiente, perspectiva, projetor mental, etc}.

Fontes: Ra Uru Hu The Human Design System + Chetan Parkyn + Lynda Bunnell.

2022-08-20 — Sinastria + composto + Davison no servidor

Astrologia relacional (sinastria, composto, Davison) implementada no servidor. Primeiros disponíveis por meio de /v1/synastry, /v1/composite, /v1/davison. Marcador de expansão para análise relacional.

Validado contra Solar Fire / Astrodienst — drift dentro do erro do método (≤0,5″ no cálculo médio).

2022-07-28 — Sinastria, composto, Davison + sinastria de grupo (+5 endpoints)

• /synastry — comparação de relacionamento com matriz de aspectos.
• /composite — composto de midpoint de Robert Hand.
• /davison — composto de tempo-lugar de Ronald Davison.
• /group-synastry — matriz de sinastria de multi-pessoas (3+).

Fontes: Hand Planets in Composite, Davison Synastry, Lois Sargent.

2022-04-15 — app.astroway.info SPA — produto de consumo ao vivo

Lançado app.astroway.info — SPA em React/TypeScript que se conecta ao backend por meio de /v1/*. Contas de usuário, cartas salvas, escolhidas. Marcador de transição de um site apenas para um produto completo.

Este mesmo backend mais tarde se torna a base da API pública.

2022-03-18 — Dignidades essenciais + recepções + almuten + partes árabes (+13 endpoints)

Astrologia clássica:

• /essential-dignities — domicílio, exaltação, triplicidade, termos, faces.
• /receptions — detecção de recepção mútua.
• /almuten — Almuten Figuris (governante da carta).
• /arabic-parts — Sortes de Fortuna, Espírito, Eros, Necessidade e outros 30+ lotes helênicos.
• /hyleg — hyleg + alcocoden.
• /algol-minimum + /fixed-stars — estrelas fixas.

Fontes: Lilly Christian Astrology + Brennan Hellenistic Astrology.

2021-08-10 — Calendário de trânsito + calendário de previsão + retorno de fase (+10 endpoints)

• /transit-calendar — momentos exatos de trânsitos nos próximos 6/12 meses.
• /forecast-calendar — previsões mensais.
• /phase-return — retorno solar, retorno lunar, retorno de Saturno, retorno de Júpiter.
• /eclipse-analysis — eclipses no contexto da carta natal.

2021-04-05 — Cálculo de aspectos + expansão de sistemas de casas (+8 endpoints)

• /aspects — matriz de aspectos completa com tabelas de orbe (Ptolomeu, moderno, asteroide).
• /coalescent — pontos coalescentes.
• /disposition-chains — cadeias de governança planetária.
• Expansão de sistemas de casas: Placidus, Koch, Igual, Todo, Campanus, Regiomontanus, Topocêntrico, Porfírio, Alcabitius, Morino.

2020-07-10 — Matriz de aspectos + aspectos clássicos

Estabilizamos a essência da suíte de cálculo. /v1/aspects pronto: suporte a conjunção, oposição, quadratura, trígono, sextil com orbes ptolemaicas. Fundamento para toda a análise posterior (trânsitos, sinastria, retornos).

Compilação WASM da Swiss Ephemeris finalmente integrada — ~5x mais rápida do que o modelo analítico anteriormente usado.

2020-06-15 — Horóscopo diário/semanal + interpretações (+4 endpoints)

• /horoscope/daily/{sign} — horóscopo diário para cada signo.
• /horoscope/weekly + /horoscope/monthly — horóscopos semanais / mensais.
• /sun-signs — significados de signos solares.

Texto gerado por equipe editorial manual (textos LLM-augmentados vieram mais tarde em 2024).

2020-03-20 — Sinastria beta + extras de efeméride (+5 endpoints)

• /synastry-beta — sinastria inicial (lançamento completo em 2022).
• /ephemeris/{planets, asteroids, lunar-nodes} — histórico 1900-2100.
• /extra — estrelas fixas, Lua Negra Lilith, Quíron.

2020-02-20 — Esqueleto da API REST + OpenAPI 2.0

Publicada a especificação interna OpenAPI 2.0. Primeiro namespace /v1/*. Autenticação por meio do cabeçalho X-Api-Key. Infraestrutura de rate limiting pronta.

Milestone interno — a API pública será lançada mais tarde, mas o contrato é estável a partir deste momento.

2019-12-15 — Motor de cálculo de carta interna

Primeira implementação servidor de /chart (privada). Casas Placidus, ofsets siderais, cálculo de planetas, estrelas fixas. Testado contra a baseline do Astro.com.

Completamente Node.js — abandonamos a lógica PHP-only anterior.

2019-09-25 — Lançamento inicial

Primeiro lançamento público da API de Astrologia AstroWay. Funcionalidade básica:

• /chart — carta natal (planetas, casas, ascendente, MC).
• /transit — posições de trânsito atuais.
• /aspects — matriz de aspectos básica (conjunções, oposições, quadraturas, trígono, sextil).
• /horoscope — horóscopo diário (por signo solar).
• /ephemeris — efemérides para qualquer data.
• /health — verificação de saúde.

Especificação OpenAPI 2.0, REST/JSON, autenticação X-Api-Key. Backend na Swiss Ephemeris. Plano gratuito — 1000 solicitações / mês.

2019-09-01 — Integração da Swiss Ephemeris — fundamento

Biblioteca Swiss Ephemeris 2.x integrada no backend astroway.info. Precisão sub-arcsecond de posições planetárias, nodos lunares, asteroides dentro de 1900–2100.

Todos os endpoints de cálculo subsequentes dependem deste nível. A mesma biblioteca usada no Solar Fire, Kepler, Astro Gold, Astrodienst.