에이전트 작업

이 페이지는 30일간의 판매 로그를 기반으로 작성됐으며, 상상이 아니라 실제 데이터야. 아래는 키를 가진 통합자들이 실제로 호출하는 API들로, 호출 빈도 순이야.

가장 많이 호출되는 것

엔드포인트	30일간 성공 호출 수	목적
POST /v1/human-design	12 563	바디그래프: 타입, 프로필, 권위, 채널
POST /v1/chart	11 763	출생 차트: 행성, 하우스, 어스펙트
POST /v1/transits	1 999	해당 날짜에 대한 트랜싯
POST /v1/vedic/dashas/vimshottari/maha	1 272	베다식 비므쇼타리 기간
POST /v1/houses	861	행성 없이 궁극점과 각도만
POST /v1/planets	761	천체 위치만
POST /v1/acg	704	천문 지도학, 전 세계 라인
POST /v1/transit-calendar	678	기간별 트랜싯 캘린더
POST /v1/horoscope/daily	549	하루 텍스트 (AI)
POST /v1/synastry	437	두 차트의 궁합

GET /v1/auth/keys/me (262)도 같은 목록에 있어: 에이전트가 작업 전에 키를 확인해. 이건 무료이고 크레딧을 소모하지 않아.

최소 호출

하나의 요청 본문이 chart, houses, planets, human-design, transits 및 다른 차트 엔드포인트에 모두 적용돼:

terminal

curl -X POST https://api.astroway.info/v1/chart \
-H "X-Api-Key: aw_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'

필드 규칙은 여기서 확인해: 필드 포맷. aw_test_* 키는 크레딧을 소모하지 않으니, 개발할 때 이걸 사용해.

스펙을 읽어, 추측하지 마

각 오퍼레이션 페이지는 markdown 복제본을 가지고 있어: 같은 URL에 .md를 붙인 거야. 모델에 HTML 대신 이걸 줘야 해.

terminal

curl https://api.astroway.info/docs/api/operations/acg_categories_get.md

옆에: /llms.txt 은 진입점이고, /v1/openapi.json 은 전체 스펙이야.

키가 필요 없을 때

키 없이도 동작하는 네임스페이스가 세 개 있어, 모두 IP당 제한이 있어: /v1/public/* (페이지 무료에 나열된 9개의 계산 엔드포인트), /v1/embed/* (준비된 위젯) 그리고 /v1/reference/* (참조: 별자리, 행성, 어스펙트).

키 없이 응답에는 _footer 라는 서명 필드가 추가돼, 이게 정상이며 무료 레벨을 나타내는 방식이야.

다음

• 일반 오류: 주로 4xx 반환
• 함정: 놀라운 동작
• MCP: Claude, Cursor 등용 도구 카탈로그 하나