AstroWay/api v2.74.2 · vi
tất cả hệ thống hoạt động bình thường

// sdk · official clients

SDK cho 11 ngôn ngữ.

Client chính thức với kiểu dữ liệu đầy đủ, retry logic, intelligent rate-limiting. Chỉ 4 dòng code để gọi API — không cần dùng cURL hay header thủ công. 8 ngôn ngữ đã sẵn sàng, 3 đang phát triển, tất cả đều sinh từ OpenAPI 3.1.

Đã phát hành

// duy trì bởi AstroWay · đồng bộ OpenAPI cùng ngày
mcp-hosted đã phát hành

MCP được lưu trữ — không cài đặt cho Claude Web/Desktop/Cursor

Điểm cuối HTTP có thể stream được lưu trữ tại mcp.astroway.info/mcp — cùng danh mục 700+ công cụ như gói npm, không cần cài đặt cục bộ. Một URL, một Bearer header, và AI client của bạn có thể truy cập toàn bộ hệ sinh thái AstroWay. Đa người dùng: tín dụng được trừ từ tài khoản sở hữu Bearer key của bạn.

https://mcp.astroway.info/mcp đọc hướng dẫn SDK →
mcp đã phát hành

MCP server (stdio) cho Claude / Cursor / GPT

@astroway/mcp chính thức: cung cấp tất cả 700+ endpoint API của AstroWay dưới dạng công cụ cho AI agent. Hoạt động với Claude Desktop, Cursor, GPT MCP clients. Chế độ stdio — khóa của bạn được giữ trên máy, không cần kết nối mạng. Đối với trường hợp không cài đặt, hãy sử dụng endpoint được lưu trữ thay thế.

npx -y @astroway/mcp đọc hướng dẫn SDK →
typescript đã phát hành

TypeScript SDK cho API AstroWay

Official `@astroway/sdk` — lớp wrapper mỏng trên `openapi-fetch` (~6 KB runtime). Tự động hoàn thành đường dẫn + kiểu dữ liệu request/response trong IDE cho tất cả {endpoints}+ endpoints. Cấu trúc lỗi kiểu Stainless, tự động retry trên 408/409/429/5xx, OIDC + SLSA L3 provenance.

npm install @astroway/sdk đọc hướng dẫn SDK →
python đã phát hành

SDK Python cho AstroWay API

Chính thức `astroway` trên PyPI — `Astroway` (đồng bộ) + `AsyncAstroway` (bất đồng bộ) trên `httpx`. Mặt bề相同 — cùng API trên cả hai client. Hierarchy lỗi Stainless-style, thử lại trên 408/409/429/5xx, gói PEP 561 typed. Python 3.9+, Nhà xuất bản đáng tin cậy OIDC.

pip install astroway đọc hướng dẫn SDK →
php đã phát hành

SDK PHP cho AstroWay API

Chính thức `astroway/sdk` trên Packagist — xây dựng trên Guzzle 7 + PSR-18. PHP 8.1+(thuộc tính chỉ đọc, nâng cấp constructor). Hierarchy lỗi kiểu Stainless, middleware retry tích hợp trên 408/409/429/5xx, hai sơ đồ xác thực (X-Api-Key mặc định hoặc Bearer).

composer require astroway/sdk đọc hướng dẫn SDK →
react đã phát hành

Người bạn đồng hành React của @astroway/sdk

Chính thức `@astroway/react` trên npm — một lớp bọc mỏng theo phong cách Stripe cho `@astroway/sdk`. `AstrowayProvider` nâng client lên ngữ cảnh React; các hook `useAstroway`, `useAstrowayQuery`, `useNatalChart` trả về một bộ ba `{ data, error, loading }` theo phong cách SWR mà không có phụ thuộc bên ngoài. Hoạt động với React 18+, Next.js App Router (qua "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react đọc hướng dẫn SDK →
symfony đã phát hành

Gói Symfony cho AstroWay API

Chính thức `astroway/sdk-symfony` trên Packagist — một Gói trên `astroway/sdk`. Tự động đăng ký qua Symfony Flex, cấu hình thông qua `config/packages/astroway.yaml` tiêu chuẩn, hiển thị dịch vụ `Astroway\Astroway` tự động kết nối để tiêm vào bất kỳ bộ điều khiển hoặc dịch vụ nào. Tương thích với Symfony 6.4 LTS và 7.x, PHP 8.1+.

composer require astroway/sdk-symfony đọc hướng dẫn SDK →
laravel đã phát hành

Nhà cung cấp dịch vụ Laravel cho AstroWay API

Chính thức `astroway/sdk-laravel` trên Packagist — Nhà cung cấp dịch vụ + фасад trên `astroway/sdk`. Tự động phát hiện qua `composer.json` `extra.laravel.providers`, `AstrowayAstroway` được đăng ký as một singleton container, cấu hình được xuất bản qua `php artisan vendor:publish`. Tiêm vào các bộ điều khiển hoặc sử dụng фасад `Astroway::post("/chart", ...)` . Làm việc với Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel đọc hướng dẫn SDK →

4 dòng code cho request đầu tiên

// TypeScript · cùng pattern trên Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk xem ví dụ đầy đủ →
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);

Sắp ra mắt

// roadmap · thông báo khi có bản mới

Tự xây wrapper

// OpenAPI 3.1 · ngôn ngữ của bạn, quy ước của bạn

Không thấy ngôn ngữ mình cần trong danh sách? Tất cả endpoints được mô tả trong OpenAPI 3.1 chuẩn — tự sinh client bằng openapi-generator hoặc stainless.