천문학 시간대 지원 도구¶

이 도구를 사용하여 상대적인 날짜 보고 경로 (today, yesterday, tomorrow)를 호출하기 전에 사용 가능한 IANA 시간대 ID를 가져옵니다.

이를 통해 지역 간의 날짜 차이 오류를 방지하고, 서로 다른 지리적 위치에 있는 사용자가 올바른 현지 날짜를 확인하도록 보장합니다.

엔드포인트¶

방법	경로
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

인증¶

API 키 헤더를 제공하십시오:

X-API-Key: YOUR_API_KEY

요청 매개변수¶

이 엔드포인트는 쿼리 또는 본문 매개변수를 필요로 하지 않습니다.

예제 요청¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/timezones" \
  --header "X-API-Key: YOUR_API_KEY"

예제 응답¶

{
  "count": 596,
  "timezones": [
    "Africa/Abidjan",
    "Africa/Accra",
    "Africa/Addis_Ababa"
  ]
}

응답 필드¶

필드	유형	설명
`count`	정수	반환된 사용 가능한 시간대 ID의 총 개수.
`timezones`	문자열 배열	지원되는 IANA 시간대 이름.

통합 워크플로우¶

/api/v1/horoscope/timezones을 한 번 호출하고 목록을 백엔드/클라이언트에 캐시합니다.
사용자가 선택한 시간대를 해당 목록과 비교합니다.
검증된 시간대를 일일 보고 요청에서 전송합니다.

시간대가 포함된 예제 일별 요청:

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "TAURUS",
  "timezone": "America/New_York",
  "sections": ["general"]
}'

참고 사항¶

유효한 IANA 형식 (예: America/New_York, Africa/Douala, Asia/Tokyo)을 사용하십시오.
EST, PST 또는 GMT+1와 같은 약어를 피하십시오.
count는 환경 및 tzdata 버전에 따라 약간 다를 수 있습니다.