콘텐츠로 이동

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, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh.

예제 요청

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-08-18T00:05:59.013552",
  "reading": [
    {
      "position": "past",
      "card": "Wheel of Fortune",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909507/10-WheelOfFortune_fokxki.png",
      "meaning": "The Wheel of Fortune represents fate, cycles, and unexpected change. Upright, it signals a turning point—often in your favor—and encourages you to embrace life’s ups and downs with faith. This card highlights karma, luck, and the interconnectedness of all things. Trust the universe’s rhythm and stay adaptable."
    },
    {
      "position": "present",
      "card": "The Devil",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/15-TheDevil_ztmvio.png",
      "meaning": "The Devil card highlights temptation, addiction, and material bondage. Upright, it reveals areas where you feel trapped or powerless—often by your own desires or fears. It challenges you to confront unhealthy attachments and reclaim your autonomy. Awareness is the first step toward liberation."
    },
    {
      "position": "future",
      "card": "Six of Pentacles",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909583/Pentacles06_REVERSED_ccxi5g.png",
      "meaning": "Reversed, the Six of Pentacles may indicate inequality, strings attached to help, or financial imbalance. Beware of hidden motives or unhealthy dependencies in relationships or money matters."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "e7d2f5dafe249067",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "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-08-18T01:05:59.033692+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

대시보드 열기


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

관련 엔드포인트