AstroWay/api v2.254.12 · pt
todos os sistemas normais

// sdk · clientes oficiais

SDK para TypeScript, Python, PHP, Go, C# / .NET.

Clientes oficiais com tipagem completa, lógica de retry, rate-limiting inteligente. Faça uma solicitação em 4 linhas de código - sem trabalho manual com cURL e headers. Em desenvolvimento: Ruby, Rust. Todos gerados a partir do OpenAPI 3.1.

Lançado

// mantido por AstroWay · sincronização diária do OpenAPI
mcp-hosted lançado

MCP alojado - sem instalação para Claude Web / Desktop / Cursor

Ponto de acesso HTTP alojado em mcp.astroway.info/mcp - mesmo catálogo de mais de 700 ferramentas que o pacote npm, sem instalação local. Uma URL, um cabeçalho Bearer e o teu cliente de IA vê todo o ecossistema AstroWay. Multi-inquilino: os créditos são debitados da conta que possui a tua chave Bearer.

https://mcp.astroway.info/mcp leia o guia do SDK →
mcp lançado

Servidor MCP (stdio) para Claude / Cursor / GPT

Servidor oficial @astroway/mcp: expõe todos os 700+ endpoints da API AstroWay como ferramentas para agentes de IA. Funciona com clientes MCP do Claude Desktop, Cursor, GPT. Modo stdio - a tua chave permanece no teu dispositivo, sem saltos de rede. Para cenários sem instalação, usa antes o endpoint alojado.

npx -y @astroway/mcp leia o guia do SDK →
typescript lançado

SDK TypeScript para a API AstroWay

Oficial @astroway/sdk - wrapper fino sobre openapi-fetch (~6 KB de tempo de execução). Autocompletar de caminhos + tipos de solicitação/resposta no seu IDE para todos os 771+ endpoints. Hierarquia de erros em estilo Stainless, retry embutido em 408/409/429/5xx, OIDC + SLSA L3 provência.

npm install @astroway/sdk leia o guia do SDK →
python lançado

SDK Python para a API AstroWay

Oficial astroway no PyPI - Astroway (sync) + AsyncAstroway (async) em cima do httpx. Superfície idêntica - a mesma API em ambos os clientes. Hierarquia de erros no estilo Stainless, repetição em 408/409/429/5xx, pacote PEP 561 tipado. Python 3.9+, Editor Confiável OIDC.

pip install astroway leia o guia do SDK →
php lançado

SDK PHP para a API AstroWay

Oficial astroway/sdk no Packagist - construído sobre Guzzle 7 + PSR-18. PHP 8.1+ (propriedades somente leitura, promoção do construtor). Hierarquia de erros no estilo Stainless, middleware de retry integrado para 408/409/429/5xx, dois esquemas de autenticação (X-Api-Key padrão ou Bearer).

composer require astroway/sdk leia o guia do SDK →
react lançado

Companheiro React para @astroway/sdk

Oficial @astroway/react no npm - uma camada fina no estilo Stripe sobre @astroway/sdk. AstrowayProvider eleva o cliente para o contexto do React; os hooks useAstroway, useAstrowayQuery, useNatalChart retornam um triplo { data, error, loading } no estilo SWR com zero dependências externas. Funciona com React 18+, Next.js App Router (via "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react leia o guia do SDK →
ui lançado

Componentes web AstroWay (alpha)

Roda natal, fase da lua, compatibilidade, tarô e horóscopo como elementos HTML simples para qualquer site: um <script> tag de um CDN, ou npm install. Os gráficos são desenhados pelo mesmo código da API, então uma roda na tua página corresponde ao que /v1/render devolve. Alpha: os nomes dos atributos ainda podem mudar antes da 1.0.

npm install @astroway/ui@alpha leia o guia do SDK →
symfony lançado

Pacote Symfony para a API AstroWay

Oficial astroway/sdk-symfony no Packagist - um pacote baseado em astroway/sdk. Registro automático via Symfony Flex, configurado através do padrão config/packages/astroway.yaml, expõe um serviço Astroway\Astroway autowireável para injeção em qualquer controlador ou serviço. Compatível com Symfony 6.4 LTS e 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha leia o guia do SDK →
laravel lançado

Fornecedor de serviços Laravel para a API AstroWay

Oficial astroway/sdk-laravel no Packagist - um fornecedor de serviços + fachada em cima do astroway/sdk. Descoberto automaticamente via composer.json extra.laravel.providers, Astroway\Astroway registrado como um singleton de contêiner, configuração publicada via php artisan vendor:publish. Injetar nos controladores ou usar a fachada Astroway::post("/chart", ...) . Funciona com Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha leia o guia do SDK →
go lançado

Go SDK para a API AstroWay

O módulo oficial Go da AstroWay: cada ponto final da API como um método, como aw.Chart.Compute, com um context.Context em cada chamada. Repetições em 408/409/429/5xx respeitam Retry-After, e um POST mantém um Idempotency-Key, por isso uma chamada repetida não é cobrada duas vezes. Erros são testados com errors.Is, e a resposta decodifica-se no teu próprio tipo. Apenas biblioteca padrão, Go 1.22+.

go get github.com/astroway/astroway-go leia o guia do SDK →
csharp lançado

C# SDK para a API da AstroWay

Pacote Astroway.Sdk: cada ponto de extremidade da API como um método async, como aw.Chart.ComputeAsync, cancelável com um CancellationToken. Repetições em 408/409/429/5xx respeitam Retry-After, cada tipo de falha tem a sua própria exceção, e a resposta desserializa para os teus próprios registos. .NET Standard 2.0 e .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk leia o guia do SDK →

4 linhas para a primeira solicitação

// TypeScript · mesmo padrão em Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk exemplo completo →
import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant);  // 212.0952574979425

Em breve

// roadmap · notificaremos quando for lançado

Sua própria wrapper

// OpenAPI 3.1 · sua língua, suas convenções

Não encontrou sua língua em nossa lista? Todos os endpoints são descritos no padrão OpenAPI 3.1 - gere seu próprio cliente usando openapi-generator ou stainless.