// sdk · TypeScript
AstroWay API용 TypeScript SDK
공식 `@astroway/sdk` — `openapi-fetch` 기반 가벼운 래퍼 (~6 KB 런타임). 모든 {endpoints}+ 엔드포인트에 대해 IDE에서 경로 자동완성 + 요청/응답 타입 제공. Stainless 스타일 오류 계층, 408/409/429/5xx 응답 시 자동 재시도, OIDC + SLSA L3 프로비전.
// 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에서 생성되며 백엔드와 항상 동기화됩니다.