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

// sdk · clientes oficiais

SDK para 11 línguas.

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. 8 línguas em produção, 3 — em desenvolvimento, todas geradas com 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 {endpoints}+ 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 →
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 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 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',
  },
});

console.log(chart.angles.asc);

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.