카탈로그 맵: AstroWay의 700+ 엔드포인트 구조

AstroWay 카탈로그는 57 그룹의 1000 이상의 엔드포인트를 보유하고 있습니다. 이 규모에 따라 개발자의 주요 문제는 “커버리지가 충분한가?”가 아니라 “어디로 가야 할까?”입니다. 이 문서는 카탈로그의 구조와 각 도메인에 대한 정보를 제공합니다.

각 계산 엔드포인트의 형식은 다음과 같습니다.

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

바디 - JSON 데이터 (생년월일, 시간, 좌표 또는 특정 기술에 대한 매개변수) 또는 기술에 대한 특정 매개변수. 응답은 항상 { "ok": true, "data": {...} } 또는 { "ok": false, "error": {...} }입니다. GraphQL, 별도의 인증 흐름은 없습니다. 하나의 API 키 헤더 X-Api-Key와 일관된 응답 형식이 있습니다.

이 패턴은 BaZi, Run, 또는 다른 기술에 대한 커버리지에 대한 변경 사항만이 있습니다. 경로와 바디의 스키마만이 달라집니다.

카탈로그는 큰 도메인으로 그룹화됩니다. 다음은 실제 카탈로그의 예입니다. (숫자는 manifests에 따라 항상 최신입니다.)

그 외에는 AI 해석, 호로스콕, 도움말 엔드포인트 (징크, 행성, 아스텍스), 시스템 (건강, 사용률, OpenAPI) 등이 있습니다.

174 베다 엔드포인트는 서양 천문학보다 더 많습니다. 이유는 간단합니다. 베다 전통은 더 정형화되어 있습니다. 서양 천문학은 하나의 집합체에 대한 하나의 세트를 가지고 있지만 베다는 16 개의 분할 카드 (바르가), 여러 대샤, 여러 요가와 정밀한 규칙을 가지고 있습니다. 각자는 별개의 엔드포인트이며 결과가 정의되어 있습니다.

서양 천문학에 대한 개발자는 인도 시장에 대한 개발자일 수 있습니다. 이 핵심 제품은 앱이 아닌 도구입니다.

각 기술의 외형에 관계없이, 행성 위치는 스위스 에페메리스 (WASM)에서 하나의 핵심으로 계산됩니다. 동일한 핵심은 브라우저의 애플리케이션과 API 서버의 애플리케이션 모두에서 작동합니다. 계산 엔드포인트는 873 스냅샷 테스트로 커버되어 있으며 각 PR에서 표준 소스와 비교됩니다. 자세한 내용은 CI 정확성에 대한 별도의 문서에서 확인하십시오.

3 가지 방법으로 찾을 수 있습니다.

1. OpenAPI 가이드 - /docs/api/는 openapi.json의 프로덕트 스펙에 직접 생성됩니다. 그룹은 사이드바의 도메인과 일치합니다. 각 엔드포인트는 바디의 스키마, 예시, 및 “시도” 버튼이 있습니다.
2. MCP 카탈로그 - Claude 또는 Cursor의 경우, 전체 카탈로그는 mcp.astroway.info를 통해 인스트루먼트 세트로 제공됩니다. 에이전트는 설명에 따라 필요한 엔드포인트를 찾습니다.
3. 스펙에 대한 검색 - curl https://api.astroway.info/v1/openapi.json은 전체 머신-readable 계약을 반환합니다. 코드 생성을위한 편리한 방법입니다.

대시보드/회원가입에서 10,000 크레딧을 제공합니다. 이는 10개 이상의 도메인과 관련된 이해를 얻을 수 있습니다. 카탈로그를 완전히 공부할 필요는 없습니다. 자신의 도메인에 대해 공부하고 나머지 도메인에 대한 공부는 나중에 할 수 있습니다.