콘텐츠로 이동
AstroWay/api v2.325.0 · ko
모든 시스템 정상 작동 중

주의사항

Last updated Markdown으로 보기 에이전트 설정

이것들은 모두 오류가 아닙니다. 문서에서 이러한 동작에 대해 배우면, 다른 사람의 응답을 분석하는 것보다 낫습니다.

무료 요금제 및 모든 키가 없는 호출은 응답 본문에 _footer 필드를 추가로 포함하며, 이는 서명입니다. 유료 키는 이를 볼 수 없습니다. 만약 파서가 부가적인 필드에 엄격하다면, 이것이 첫 번째 장애물이 될 것입니다.

캐시 창 동안 동일한 요청은 X-Cache: HIT를 반환하며, 이러한 호출은 크레딧을 소모하지 않습니다: 응답에서 X-Credits-Used: 0이며, 잔액은 그대로 반환됩니다. 즉, 동일한 요청을 반복하여 비용을 측정하는 것은 불가능합니다: 한 번만 지불하세요.

Sandbox 키는 아무 것도 소모하지 않음

섹션 제목: “Sandbox 키는 아무 것도 소모하지 않음”

aw_test_*는 전혀 크레딧을 소모하지 않으며 계정의 한도를 포함하지 않습니다. 이것은 “작은 할당량”이 아닌, 0입니다. 개발은 이 키로 진행해야 하며, aw_live_*는 청구 확인 시에만 사용해야 합니다.

알 수 없는 필드는 조용히 통과됨

섹션 제목: “알 수 없는 필드는 조용히 통과됨”

본문은 추가 키를 받아서 무시합니다. 단, 명시적으로 거부된 짧은 표기법 (lat, tz 등, 필드 포맷 참조)만 예외입니다. 따라서 필드 이름의 오타는 일반적으로 영향을 미치지 않습니다: 200과 계산된 매핑을 받게 되며, 당신의 매개변수 없이 계산됩니다.

극지방에서는 집 시스템이 대체됨

섹션 제목: “극지방에서는 집 시스템이 대체됨”

quadrant 시스템의 경우 |latitude| > 66.5°일 때, 아스펙트(cusp)는 Porphyry로 계산됩니다. 이는 이러한 시스템이 정의되지 않기 때문입니다. 우리는 이를 숨기지 않습니다: 응답에 warning 필드가 추가됩니다. Whole Sign 및 Equal은 어떤 위도에서도 작동합니다.

인접한 경우를 우리는 거부로 처리합니다: 알 수 없는 houseSystem 코드는 더 이상 다른 이름으로 Placidus를 제공하지 않고, 대신 400을 반환합니다.

키는 세 가지 독립적인 한도를 가짐

섹션 제목: “키는 세 가지 독립적인 한도를 가짐”

브라우저 키 pk_와 비밀 키 aw_는 동시에 세 가지 제한을 가질 수 있으며, 이들은 서로 대체하지 않습니다:

한도설명거부
도메인 목록호출 가능한 위치403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED
credits_cap_cycle이 키가 소모할 수 있는 양429 KEY_BUDGET_EXHAUSTED
allowed_endpoints호출 가능한 것403 ENDPOINT_NOT_IN_SCOPE

엔드포인트 범위는 서비스 읽기 권한을 해제하지 않습니다: embed/*로 제한된 키는 자신의 통계조차 읽을 수 없습니다. 이는 의도적이며, 세부 사항은 인증에서 확인할 수 있습니다.

키의 수정은 다음 요청부터 적용됨

섹션 제목: “키의 수정은 다음 요청부터 적용됨”

키는 60초 동안 캐시됩니다. 그러나 PATCH /v1/keys/{id}를 통해 어떤 변경사항이 발생하면 캐시가 즉시 초기화됩니다. 한 분 기다릴 필요 없습니다.