콘텐츠로 이동

3장 타로 카드 리딩

3장 타로 카드 리딩은 당신의 과거, 현재, 그리고 미래에 대한 통찰력을 제공합니다. 이 방법은 이름과 생년월일을 사용하여 개인화된 세 장의 카드를 뽑아, 영향을 미치는 요소, 도전 과제, 그리고 지침을 보여줍니다.

이 리딩을 사용하여 명확성을 얻고, 패턴을 되돌아보고, 다가오는 주기들을 준비하십시오.


엔드포인트

방법 경로
GET https://api.numerologyapi.com/api/v1/tarot/reading
POST https://api.numerologyapi.com/api/v1/tarot/reading

필수 헤더

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

또한, Authorization: Bearer YOUR_API_KEY을 사용하여 인증할 수도 있습니다. Numerology API 대시보드에서 API 키를 생성하고 관리하십시오.


매개변수| 파라미터 | 타입 | 필수 여부 | 설명 |

| ------ | ------ | -------- | ----------------------------------------------------------------------------------------------- | | name | 문자열 | 예 | 전체 이름. 개인화된 결과를 제공하는 데 사용됩니다. | | dob | 문자열 | 예 | YYYY-MM-DD 형식의 생년월일. | | mode | 문자열 | 아니오 | random (기본값) 또는 daily. 매일 모드를 사용하여 동일한 날짜에 동일한 카드가 나오도록 합니다. |

응답을 로컬화하기 위해 선택 사항인 lang 쿼리 파라미터를 추가합니다. 지원되는 값: en, es, de, fr, pt.

예제 요청

GET 요청

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?name=John+Doe&dob=1992-07-16&mode=random&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST 요청 (JSON 본문)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "John Doe",
  "dob": "1992-07-16",
  "mode": "random"
}'

응답 예시

{
  "status": "success",
  "mode": "random",
  "name": "john doe",
  "dob": "1992-07-16",
  "timestamp": "2026-02-28T06:36:43.165542",
  "reading": [
    {
      "position": "past",
      "card": "Nine of Wands",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909654/Wands09_REVERSED_c1lzc8.png",
      "meaning": "Reversed, the Nine of Wands suggests burnout, defensiveness, or giving up too soon. Reassess your limits—are you fighting the right battles or exhausting yourself unnecessarily?"
    },
    {
      "position": "present",
      "card": "Queen of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909601/Pentacles13_gcz6tw.png",
      "meaning": "The Queen of Pentacles is nurturing, practical, and abundant. Upright, she embodies care for home, finances, and well-being. She balances work and family effortlessly and offers warmth and security to others."
    },
    {
      "position": "future",
      "card": "Page of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909597/Pentacles11_hbj9js.png",
      "meaning": "The Page of Pentacles is a messenger of opportunity, learning, and ambition. Upright, it signifies a student mindset, practical planning, and the start of a new venture or career path. You're ready to invest in your goals."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "20bb36de5d26843f",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "tarot_reading",
    "endpoint_description": "Generates a tarot card reading with interpretations and guidance.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:43.169490+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

대시보드 열기


!!! 참고 사항 mode=daily 는 이름, 생년월일 및 현재 날짜를 기반으로 카드 뽑기를 결정하여 일관된 매일의 지침을 제공합니다. * 각 카드의 reversed 상태는 해석에 영향을 줄 수 있습니다. * image_url 는 카드 이미지를 제공하며, card_backcover 는 일반적인 역방향 카드입니다. * 카드는 과거 → 현재 → 미래* 순서로 반환됩니다.

관련 엔드포인트