AstroWay/api v2.254.12 · pt
todos os sistemas normais
// company · made in ukraine

Infraestrutura que
não falha. AstroWay.

Um cálculo astrológico é fácil de fazer de forma aproximada e difícil de fazer com exatidão. Por isso, cada versão é verificada contra o swetest da Astrodienst e o catálogo de eclipses da NASA, e publicamos a diferença.

// endpoints
771
production · OpenAPI 3.1
// CI tests
873
snapshot vs swetest + NASA Eclipse Catalog
// MCP tools
783
hosted · npm @astroway/mcp
// SDKs
3
TypeScript · Python · PHP
// 01 / mission

Tornar os cálculos astrológicos numa
infraestrutura fiável.

Os cálculos astrológicos são ciência: efemérides, precessão dos equinócios, correções de tempo de arco. Nós externalizamos isto para uma API sem erros, para que os programadores possam construir produtos, em vez de discutirem sobre sinais horários.

Uma equipa que queria construir um produto de astrologia tinha três caminhos: escrever o seu próprio motor de efemérides, comprar software de secretária sem API ou ligar uma API pública e aceitar a precisão e a cobertura que ela tivesse.

Vimos que ninguém fazia isto corretamente: cobertura total, sub-segundo de arco, transparência de preços, OpenAPI normal. Por isso, fizemo-lo nós mesmos.

// 02 / team

Uma pequena equipa
da Ucrânia.

Engenheiros e astrólogos.

O AstroWay é construído por uma pequena equipa de engenheiros e astrólogos-consultores da Ucrânia. Não somos uma startup com 50 pessoas e rondas de VC - é um produto onde cada linha de código veio de um cenário real de uso na nossa academia LMS e aplicação de consumo.

Se quiseres entrar em contacto: hello@astroway.info. Se precisares de um contrato empresarial: enterprise@astroway.info.

// empresa ucraniana, suporte em inglês, servidores na UE
// 03 / principles

Em que acreditamos.

/ 01

Primeiro a matemática, depois a UX.

Uma boa documentação e um dashboard bonito são inúteis se o mapa errar em 0.3°. Cada lançamento é verificado contra o Swiss Ephemeris de referência e o catálogo de eclipses da NASA através de 873 testes de regressão. Um único teste de regressão falhado bloqueia o lançamento.

/ 02

Um único preço, sem armadilhas.

Nenhum "a partir de", nenhum "empresarial - contacta-nos" nos planos iniciais, nenhumas surpresas com excesso de uso. O valor em /pricing é o valor na fatura. Bloqueado por 12 meses a partir da data de registo.

/ 03

Email - e nós respondemos.

Sem assistente de chatbot. O api@astroway.info vai diretamente para o engenheiro. Lemos cada email. Se estivermos a dormir, a resposta chegará quando acordarmos, geralmente com um snippet de código.

/ 04

Stack aborrecido, bem ajustado.

A stack do servidor foi escolhida pela previsibilidade, não pelo hype. Alojamento na UE. O tempo poupado no hype é investido em testes de carga, observabilidade e ergonomia do SDK. A API é rápida porque o código é pequeno.

/ 05

Honestos sobre o que falta.

Changelog público em /changelog. Documentação honesta - o que cada endpoint garante e onde estão os casos limite. Não fingimos que a retificação funciona para qualquer hora de nascimento - a documentação indica explicitamente a precisão.

/ 06

A astrologia é um ofício, não um estado de espírito.

Construído com um astrólogo praticante (academia LMS em astroway.info). Cada interpretação remonta a uma tradição que conseguimos nomear. Quando um modelo de linguagem escreve o texto, escreve-o sobre posições já calculadas e não as inventa.

// 04 / timeline

De 13 endpoints
771 endpoints.

2026-03-01

Motor de cálculo

Planetas, casas, aspetos e mapas sobre o Swiss Ephemeris. O mesmo motor calcula na aplicação app.astroway.info e nesta API.

2026-03-19

API pública

13 endpoints, chaves de API e a primeira documentação.

2026-04-11

Um produto próprio

A API mudou-se para api.astroway.info: site próprio, documentação e painel de programador.

2026-05-06

Servidor MCP

@astroway/mcp no npm: os cálculos ficam ao alcance de agentes no Claude, no Cursor e noutros clientes MCP.

2026-05-09

Três SDK

TypeScript, Python e PHP no mesmo dia, gerados a partir da mesma especificação OpenAPI.

agora

771 endpoints · 873 testes CI

Cada versão passa pelos testes de regressão contra o swetest e o catálogo de eclipses da NASA. Uma regressão e a versão não sai.

// 05 / stack

Como ele funciona.

// math engine

Núcleo computacional

  • Swiss Ephemerismotor de referência
  • NASA Eclipse Catalogverdade externa
  • 873 testes de regressãoa cada lançamento
  • Precisão sub-arcsegundoposições dos planetas
  • Segurança de tipo estrita de ponta a pontasem surpresas em tempo de execução
// api surface

Superfície pública

  • REST + JSONum contrato consistente
  • OpenAPI 3.1auto-generated spec
  • Idempotency-Keya cada POST
  • Per-key rate limitscompartilhamento honesto
  • x-request-idin logs for 30 days
// security & privacy

Posicionamento

  • EU jurisdictiondata residency
  • HTTPS / TLS 1.3 onlysem texto simples
  • Hashed credentialssem texto simples em repouso
  • IP-hash loggingGDPR-compliant
  • Acesso DPA disponívelnos planos Pro+
// reliability

Quando algo quebra

  • Health checkdiário
  • Rollback on failed healtha cada deploy
  • Backups diários30-day retention
  • Painel de incidentes públicoon /status
  • Pós-morte ≤ 5 diasincidentes sev-1
// SDKs & tooling

Como falar com ele

  • @astroway/mcpServidor MCP · npm · lançado
  • @astroway/sdkTypeScript SDK · npm
  • astrowayPython SDK · PyPI
  • astroway/sdkPHP SDK · Packagist
  • Postman collectionone-click import
  • Exemplos de cURLem cada doc
// 06 / ecosystem

Três domínios.
Um motor.

99.9% SLA · planos pagos · 30d status →

Faça a primeira requisição
em 5 minutos.

10 000 créditos gratuitos. Sem cartão. Sem limite de tempo.