// sdk · TypeScript
AstroWay API用TypeScript SDK
公式 `@astroway/sdk` — `openapi-fetch` (~6 KBランタイム)の薄いラッパー。全ての{endpoints}+エンドポイントに対しIDEでパス自動補完+リクエスト/レスポンス型を提供。Stainlessスタイルのエラー階層、408/409/429/5xx時の組み込みリトライ、OIDC + SLSA L3 provenance。
// 01 / install
インストール
npm install @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',
},
});
console.log(chart.angles.asc);TypeScriptを始める
月額10,000クレジットを無料で利用可能。Open-source SDKで、OpenAPI 3.1から自動生成され、常にバックエンドと同期しています。