// sdk · TypeScript
AstroWay API用TypeScript SDK
公式 @astroway/sdk - openapi-fetch (~6 KBランタイム)の薄いラッパー。全ての771+エンドポイントに対しIDEでパス自動補完+リクエスト/レスポンス型を提供。Stainlessスタイルのエラー階層、408/409/429/5xx時の組み込みリトライ、OIDC + SLSA L3 provenance。
// 01 / install
インストール
npm install @astroway/sdk pnpm
pnpm add @astroway/sdk yarn
yarn add @astroway/sdk bun
bun add @astroway/sdk インポート: import { Astroway } from '@astroway/sdk';
レジストリで確認する → @astroway/sdk
// 02 / highlights
特長
- 完全なTypeScript型
- OpenAPI 3.1生成
- 組み込みリトライ+バックオフ
- Stainlessスタイルのエラー
- OIDC + SLSA L3
// 03 / first request
最初のリクエスト
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.0952574979425TypeScriptを始める
月額10,000クレジットを無料で利用可能。Open-source SDKで、OpenAPI 3.1から自動生成され、常にバックエンドと同期しています。