AstroWay 카탈로그는 이제 57개 그룹에 865개의 엔드포인트를 갖추고 있습니다. 이 정도 규모에서 통합 개발자의 핵심 질문은 “커버리지가 충분한가”가 아니라 “어떻게 길을 잃지 않을까”입니다. 이 글은 지도입니다: 카탈로그가 어떻게 도메인으로 나뉘는지, 그리고 필요한 것을 1분 안에 찾는 방법을 설명합니다.
모든 호출에 하나의 패턴
섹션 제목: “모든 호출에 하나의 패턴”도메인과 관계없이 모든 계산 엔드포인트는 같은 형태를 가집니다:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/json본문은 출생 데이터(날짜, 시간, 좌표) 또는 기법별 파라미터가 담긴 JSON입니다. 응답은 항상 { "ok": true, "data": {...} } 또는 { "ok": false, "error": {...} }입니다. GraphQL도, 도메인마다 별도의 인증 흐름도 없습니다: X-Api-Key 헤더의 키 하나, 응답 형식 하나입니다.
즉 출생 차트용으로 작성한 래퍼를 BaZi에도, 룬에도 그대로 쓸 수 있습니다. 바뀌는 것은 경로와 본문 스키마뿐입니다.
카탈로그의 도메인
섹션 제목: “카탈로그의 도메인”카탈로그는 큰 도메인으로 묶여 있습니다. 실제 개수가 담긴 지도는 다음과 같습니다(숫자는 빌드할 때마다 매니페스트에서 가져오므로 항상 최신입니다):
| 도메인 | 엔드포인트 수 | 포함 내용 |
|---|---|---|
| 서양 점성술 | 186 | 출생 차트, 애스펙트, 품위(dignities), 예측(트랜짓, 프로그레션, 디렉션), horary, 헬레니즘 4개 학파, 현대 심리 점성술, 진화 점성술, 코스모바이올로지 |
| 베다 | 230 | 가장 큰 도메인: nakshatras, dashas, 분할 차트(varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | 바디그래프, 채널, 게이트, 타입/프로필/권위, 인카네이션 크로스 |
| 타로 | 71 | 세 가지 덱: Rider-Waite-Smith, Marseille, Lenormand. 스프레드, 의미, 조합 |
| 수비학 | 55 | 5개 체계, 체계마다 10개 계산(피타고라스, 칼데아, 두 가지 카발라, 베다) |
| 중국 + 마야 | 55 | BaZi(사주), Zi Wei Dou Shu, 중국 띠와 풍수, 마야 달력 |
| 점술 | 40 | 지점술(Agrippa), 엘더 푸사르크 룬, 수상학(Cheiro), I Ching |
| 응용 분야 | 53 | 웰니스, 반려동물 점성술, 비즈니스, 금융, 가족 |
| 리포트 | 29 | 바로 쓸 수 있는 해석(natal, synastry), HTML/PDF 형식, 화이트라벨 브랜딩 지원 |
| 렌더링 | 14 | SVG/PNG 차트 휠, 바디그래프, 트랜짓 링. 자체 프런트엔드 없이 사용 가능 |
| 개발 도구 | 47 | 웹훅, 실시간 스트리밍, 임베드 위젯, 화이트라벨 |
나머지는 AI 해석, 운세, 참조 엔드포인트(별자리, 행성, 애스펙트), 시스템 엔드포인트(health, usage, openapi)입니다.
베다는 별개의 이야기
섹션 제목: “베다는 별개의 이야기”230개의 베다 엔드포인트는 서양 쪽 전체보다 많습니다. 이유는 간단합니다: 베다 전통이 더 형식화되어 있기 때문입니다. 서양 점성술에 하우스 체계가 하나 있는 자리에 베다에는 16개의 분할 차트(varga), 여러 dasha 체계, 명확한 규칙을 가진 수십 가지 yogas가 있습니다. 이 각각이 결정론적 결과를 내는 별도의 엔드포인트입니다.
인도 시장을 대상으로 한다면 이것은 부가 기능이 아니라 제품의 핵심입니다.
이 모든 것의 바탕이 되는 정확도
섹션 제목: “이 모든 것의 바탕이 되는 정확도”기법이 아무리 특이해도 행성 위치는 Swiss Ephemeris 기반의 단일 코어로 계산됩니다. 같은 코어가 우리 앱과 API에서 모두 동작하므로 코드베이스는 하나이고 차이는 없습니다. 계산 엔드포인트는 888개의 스냅샷 테스트로 보호되며, PR마다 기준 소스와 대조됩니다. 자세한 내용은 CI 정확도에 관한 별도 글에서 다룹니다.
필요한 것을 찾는 방법
섹션 제목: “필요한 것을 찾는 방법”가장 빠른 것부터 세 가지 방법이 있습니다:
- OpenAPI 레퍼런스: /docs/api/는 프로덕션 명세
openapi.json에서 직접 생성됩니다. 사이드바의 그룹이 곧 위의 도메인입니다. 각 엔드포인트에는 본문 스키마, 예제, “사용해 보기” 버튼이 있습니다. - MCP 카탈로그: Claude나 Cursor를 쓰고 있다면 전체 카탈로그를
mcp.astroway.info를 통해 도구 세트로 사용할 수 있습니다. 에이전트가 설명을 보고 필요한 엔드포인트를 직접 찾습니다. - 명세 검색:
curl https://api.astroway.info/v1/openapi.json은 기계가 읽을 수 있는 전체 계약을 반환합니다. 자체 클라이언트를 코드 생성할 때 편리합니다.
시작하기
섹션 제목: “시작하기”dashboard/sign-up에서 받은 키로 매월 10,000 크레딧을 쓸 수 있습니다. 수십 개 도메인을 둘러보고 어떤 것이 필요한지 파악하기에 충분합니다. 카탈로그 전체를 익힐 필요는 없습니다: 자신의 도메인부터 시작하고, 나머지는 필요할 때 쓰면 됩니다.