주의사항
이것 중 아무것도 오류가 아닙니다. 이것은 문서에서 배우는 것이 다른 사람의 응답을 분석하는 것보다 더 나은 동작입니다.
응답에 불필요한 _footer 필드가 있습니다
섹션 제목: “응답에 불필요한 _footer 필드가 있습니다”무료 요금제와 모든 키 없는 호출은 본문에 서명이 포함된 추가 _footer 필드를 받으며, 유료 키는 이를 볼 수 없습니다. 파서가 불필요한 필드에 엄격하다면, 이것이 가장 먼저 문제가 될 것입니다.
동일한 호출 반복은 비용이 0입니다
섹션 제목: “동일한 호출 반복은 비용이 0입니다”캐시 윈도우 내에서 동일한 요청은 X-Cache: HIT를 반환하며, 이러한 호출은 크레딧을 차지하지 않습니다: 응답에는 X-Credits-Used: 0이 표시되고 잔액이 다시 반환됩니다. 즉, 동일한 요청을 반복해서 실행하여 비용을 측정할 수 없습니다: 한 번만 지불합니다.
샌드박스 키는 아무것도 소모하지 않습니다
섹션 제목: “샌드박스 키는 아무것도 소모하지 않습니다”aw_test_*는 전혀 크레딧을 차지하지 않으며 계정 한도에 포함되지 않습니다. 이것은 “작은 할당량”이 아니라 0입니다. 개발은 이 키로 진행하고, 청구를 확인할 때 aw_live_*를 사용해야 합니다.
알 수 없는 필드는 무시됩니다
섹션 제목: “알 수 없는 필드는 무시됩니다”본문은 추가 키를 허용하고 무시합니다. 명시적으로 거부된 약칭(lat, tz 및 기타, 필드 형식 참조)에 대한 예외만 있습니다. 따라서 필드 이름의 오타는 보통 알아차리지 못합니다: 200과 매개변수 없이 계산된 차트를 받게 됩니다.
북극권에서는 하우스 시스템이 자동으로 변경됩니다
섹션 제목: “북극권에서는 하우스 시스템이 자동으로 변경됩니다”사분면 시스템에서 |latitude| > 66.5°일 때 Swiss Ephemeris는 자동으로 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}를 통한 모든 변경은 즉시 캐시를 재설정합니다. 1분을 기다릴 필요가 없습니다.