# 에이전트 작업

이 페이지는 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` 및 다른 차트 엔드포인트에 모두 적용돼:

<Code lang="bash" title="terminal" code={`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}'`} />

필드 규칙은 여기서 확인해: [필드 포맷](/agent-setup/field-formats/). `aw_test_*` 키는 크레딧을 소모하지 않으니, 개발할 때 이걸 사용해.

## 스펙을 읽어, 추측하지 마

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

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

옆에: [`/llms.txt`](https://api.astroway.info/llms.txt) 은 진입점이고, [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) 은 전체 스펙이야.

## 키가 필요 없을 때

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

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

## 다음

- [일반 오류](/agent-setup/mistakes/): 주로 4xx 반환
- [함정](/agent-setup/gotchas/): 놀라운 동작
- [MCP](/agent-setup/): Claude, Cursor 등용 도구 카탈로그 하나