ホロスコープ タイムゾーン ヘルパー¶

相対的な日レポートのルート (today, yesterday, tomorrow) を呼び出す前に、受け入れられた IANA タイムゾーン ID を取得するためにこのヘルパーを使用します。

これにより、地域間の日付のずれを防ぎ、異なる地理的場所にいるユーザーが正しいローカルの日を認識できるようにします。

エンドポイント¶

認証¶

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"
  ]
}

レスポンスフィールド¶

統合ワークフロー¶

1. /api/v1/horoscope/timezones を一度呼び出し、リストをバックエンド/クライアントにキャッシュします。
2. ユーザーが選択したタイムゾーンをそのリストと照合します。
3. 検証されたタイムゾーンを日次レポートのリクエストで送信します。

タイムゾーンを含むサンプルの日次リクエスト:

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 バージョンによって若干異なる場合があります。