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

// sdk · official clients

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

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. Đang phát triển: Ruby, Rust. 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ả 771+ 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 →
ui đã phát hành

AstroWay web components (alpha)

Bánh xe Natal, phái ánh trăng, tương hợp, tarot và cung hoàng đạo dưới dạng các phần tử HTML thuần cho bất kỳ trang nào: chỉ một thẻ <script> từ CDN, hoặc npm install. Các biểu đồ được vẽ bằng cùng mã như API, vì vậy bánh xe trên trang của bạn sẽ khớp với kết quả của /v1/render. Alpha: tên thuộc tính có thể vẫn thay đổi trước 1.0.

npm install @astroway/ui@alpha đọ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:^0.1.0-alpha đọ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, Astroway\Astroway đượ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:^0.1.0-alpha đọc hướng dẫn SDK →
go đã phát hành

Go SDK cho API AstroWay

Module Go chính thức của AstroWay: mỗi endpoint API là một phương thức, ví dụ aw.Chart.Compute, kèm context trong mọi cuộc gọi. Thử lại khi nhận 408/409/429/5xx tuân theo Retry-After, và POST giữ Idempotency-Key, nên gọi lại không bị tính phí hai lần. Lỗi được kiểm tra bằng errors.Is, và phản hồi được giải mã vào kiểu của bạn. Chỉ dùng thư viện chuẩn, Go 1.22+.

go get github.com/astroway/astroway-go đọc hướng dẫn SDK →
csharp đã phát hành

SDK C# cho API AstroWay

Gói Astroway.Sdk: mọi endpoint API thành phương thức async, như aw.Chart.ComputeAsync, có thể hủy bằng CancellationToken. Tự động thử lại khi nhận 408/409/429/5xx và tôn trọng Retry-After, mỗi loại lỗi có exception riêng, và phản hồi được giải tuần tự thành các record của bạn. .NET Standard 2.0 và .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk đọ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',
  },
});

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

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.