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

코드 없는 통합

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

이 페이지의 모든 내용은 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, 스크립트 또는 워크플로우를 편집할 수 있는 사람은 누구나 내부에 키를 볼 수 있습니다. 따라서 각 자동화에 고유한 키를 부여하고 해당 자동화가 수행하는 작업으로 제한하세요.

  1. 대시보드에서 API 키를 열고 새 키를 클릭하세요. 자동화 이름을 따서 zapier-intake-form과 같이 이름을 지정하세요.
  2. 이 키는 어디에서 사용됩니까? 필드에서 서버 전용을 선택하세요.
  3. 키를 복사하여 저장하세요. 대화 상자에서 키가 한 번만 완전히 표시됩니다. 키를 잃어버린 경우, 키 메뉴에서 키 새로고침을 클릭하세요. 새 키를 받게 되며, 이전 키는 작동을 멈춥니다.
  4. 키 메뉴에서 엔드포인트 범위를 열고 자동화가 호출하는 경로를 한 줄에 하나씩 나열하세요: 출생 차트의 경우 chart, 일일 운세의 경우 public/horoscope/*.
  5. 동일한 메뉴에서 예산 설정을 열고 이 키가 주기당 사용할 수 있는 크레딧 수를 지정하세요.

목록에 없는 호출은 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년 5월 15일 키이우는 UTC+3이 아닌 UTC+4를 사용했습니다. 이는 수동으로 입력된 오프셋이 유발하는 오류입니다. 좌표에서 시간대를 가져오려면 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 물고기자리.

가장 인기 있는 세 가지 값은 다음과 같습니다:

  • 태양: "name": "Sun"을 가진 data.planets의 첫 번째 항목.
  • 달: "name": "Moon"을 가진 data.planets의 두 번째 항목.
  • 어센던트: data.houses.ascendant.
  • 사용된 오프셋: data.input.timezoneOffset.

위 예시의 경우: 태양 54.34는 황소자리; 달 296.39는 염소자리; 어센던트 159.26은 처녀자리; 오프셋 4.

  • POST /v1/chart는 20 크레딧이 소모됩니다. 전체 표는 엔드포인트 비용 페이지에서 확인할 수 있습니다.
  • 동일한 요청이 5분 이내에 다시 전송되면 캐시에서 반환되며 크레딧이 차감되지 않습니다. 동일한 본문을 반복하는 테스트 실행은 예산을 소모하지 않습니다.
  • GET /v1/public/horoscope/daily는 크레딧을 소모하지 않습니다. 키가 없거나 무료 요금제 키를 사용하는 경우, IP 주소당 시간당 30개 요청 제한에 포함되며, 자동화 플랫폼은 클라이언트 간에 주소를 공유합니다. 유료 요금제 키는 자체 제한이 있습니다.