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

코드 없는 통합

이 페이지들의 모든 내용은 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-05-15에 UTC+4였고 +3이 아니야: 수동으로 입력한 오프셋이 이런 오류를 일으켜. auto 로 보내면 좌표에서 영역을 가져와.
  • timezone 없이 오프셋 없이 하면 차트는 UTC 기준으로 계산돼. 응답은 여전히 200 이라서, 필드가 매핑됐는지 확인해.
  • timezone400 으로 거부돼, 그렇지 않으면 비어있는 폼 필드가 UTC로 해석될 테니까.
  • dateYYYY-MM-DD 형식, timeHH: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 요청 제한에 포함돼, 자동화 플랫폼은 주소를 클라이언트 간에 나눠 쓰지. 유료 요금제 키는 별도 제한을 가져.
도움이 되었나요?
Запропонувати правку

마지막 업데이트: