코드 없는 통합
이 페이지들의 모든 내용은 2026-09-17 프로덕션을 기준으로 작성됐어. n8n용 워크플로우는 가져와서 실제 n8n에서 실행했어; Zapier와 Make용 단계는 각각의 도구 문서를 참고해서 작성했고, 그들이 만드는 요청은 바로 이 형태로 전송돼.
요청은 어디서 오는가
섹션 제목: “요청은 어디서 오는가”이에 따라 어떤 키가 필요한지가 결정돼.
- Zapier, Make і n8n 은(는) 자체 서버에서 보낸다. 아래에 설명된 대로 엔드포인트 영역과 예산이 포함된 “서버 전용” 키가 필요해. 안내: Zapier, Make, n8n.
- Bubble 도 자체 서버에서 요청을 보내고, 키는 헤더에 들어가며 그대로 남아 있어: Bubble.
- FlutterFlow 는 사용자가 보유한 앱으로 컴파일되므로 호출을 프라이빗하게 해야 해: FlutterFlow.
- Wix, Squarespace, Shopify, Webflow і Tilda 는 방문자의 브라우저에 페이지를 표시해. 위젯을 삽입하고, 키는 넣지 마: 사이트 빌더.
- WordPress 는 네 자체 서버에서 호출해. 키 관리는 AstroWay 플러그인이 담당해.
자동화용 키
섹션 제목: “자동화용 키”Zap, 스크립트, 워크플로우를 편집할 수 있는 사람은 모두 키를 내부에서 볼 수 있어. 그래서 각 자동화마다 별도 키를 만들고, 그 키가 하는 일에만 제한을 걸어.
- 대시보드에서 API-키를 열고 새 키 를 클릭해. 자동화 이름으로 지정해, 예를 들어
zapier-intake-form. - 이 키를 어디에 사용할 건가요? 필드에서 서버 전용 을 유지해.
- 키를 복사해. 대화창에 한 번 전체가 표시되고, 이후에는 키 메뉴의 보이기 로 확인할 수 있어.
- 키 메뉴에서 엔드포인트 영역 을 열고 자동화가 호출하는 경로를 한 줄에 하나씩 적어:
chart은 탄생 차트용,public/horoscope/*은 일일 운세용. - 같은 메뉴에서 예산 설정 을 열고, 이 키가 사이클당 사용할 수 있는 크레딧 양을 지정해.
목록에 없는 호출은 403 ENDPOINT_NOT_IN_SCOPE 를 반환해. 예산을 다 쓴 키는 429 KEY_BUDGET_EXHAUSTED 를 반환하는데, 계정에 크레딧이 남아 있어도 마찬가지야. 그래서 무한 루프에 빠진 자동화는 지정된 횟수에서 멈춰. 두 제한 모두 어떤 요금제에서도 적용되며, 인증 섹션에 설명돼 있어.
출생 순간을 보내고, 오프셋은 보내지 마
섹션 제목: “출생 순간을 보내고, 오프셋은 보내지 마”폼은 날짜, 시계 시간, 위치를 제공해. 다음과 같이 보내줘:
{ "date": "1990-05-15", "time": "14:30:00", "timezone": "Europe/Kyiv", "latitude": 50.45, "longitude": 30.52}timezone은 영역 이름이고, 서버가 해당 날짜의 시계가 가졌던 UTC 오프셋과 서머타임을 자동으로 찾아. 예를 들어 키예프는 1990-05-15에 UTC+4였고 +3이 아니야: 수동으로 입력한 오프셋이 이런 오류를 일으켜.auto로 보내면 좌표에서 영역을 가져와.timezone없이 오프셋 없이 하면 차트는 UTC 기준으로 계산돼. 응답은 여전히200이라서, 필드가 매핑됐는지 확인해.- 빈
timezone은400으로 거부돼, 그렇지 않으면 비어있는 폼 필드가 UTC로 해석될 테니까. date는YYYY-MM-DD형식,time은HH:MM:SS형식으로 보내. 폼이 다른 형식으로 저장한다면, 도구 자체에서 날짜 포맷을 맞춰.- 숫자는 문자열로 올 수 있어.
\"latitude\": \"50.45\"도 받아들여, 대부분의 폼 필드가 이렇게 보낸다. - API는 지오코딩을 하지 않아. 좌표는 폼이나 도구의 지오코딩 단계에서 받아와야 해.
city필드는 단순히 라벨일 뿐.
1970년 이전 시계와 날짜 변환 규칙은 필드 포맷 에 설명돼 있어.
경도를 별자리로 변환하는 방법
섹션 제목: “경도를 별자리로 변환하는 방법”POST /v1/chart 은 황도에 따라 각도로 응답하고, { "ok": true, "data": { ... } } 형태의 래퍼에 담겨. 별자리는 floor(longitude / 30) 로 계산하고, 0부터 시작해:
0 양자리, 1 황소자리, 2 쌍둥이자리, 3 게자리, 4 사자자리, 5 처녀자리, 6 천칭자리, 7 전갈자리, 8 사수자리, 9 염소자리, 10 물병자리, 11 물고기자리.
가장 흔한 세 값은 다음에 있어:
- 태양:
data.planets에서"name": "Sun"로 첫 번째 항목. - 달:
data.planets에서"name": "Moon"로 두 번째 항목. - 상승점:
data.houses.ascendant. - 사용된 오프셋:
data.input.timezoneOffset.
위 예시에서는: 태양 54.34 → 황소자리; 달 296.39 → 염소자리; 상승점 159.26 → 처녀자리; 오프셋 4.
비용은 얼마야
섹션 제목: “비용은 얼마야”POST /v1/chart은 20 크레딧이 소모돼. 전체 표는 엔드포인트 비용 페이지에 있어.- 같은 요청을 5분 이내에 다시 보내면 캐시에서 반환돼서 크레딧이 차감되지 않아. 같은 본문을 반복하는 테스트 실행은 예산을 소모하지 않아.
GET /v1/public/horoscope/daily은 크레딧을 사용하지 않아. 키 없이 또는 Free 요금제 키로는 IP당 시간당 30 요청 제한에 포함돼, 자동화 플랫폼은 주소를 클라이언트 간에 나눠 쓰지. 유료 요금제 키는 별도 제한을 가져.