게마트리아¶

게마트리아 엔드포인트는 어떤 텍스트든 네 가지 수리적 시스템으로 변환합니다: 1. 순열 방식: A=1, B=2, ..., Z=26 2. 역 순열 방식: A=26, B=25, ..., Z=1 3. 피타고라스 방식: A=1, B=2, ..., I=9, J=1, ..., Z=8 4. 표준 히브리어: א=1, ב=2, ..., ת=400 (히브리 문자만)

또한 순열 값을 기반으로 한 숨겨진 의미도 포함합니다.

대소문자를 구분하지 않음: 비알파벳 문자는 무시됩니다.

엔드포인트¶

방법	경로
`GET`	`https://api.numerologyapi.com/api/v1/gematria`
`POST`	`https://api.numerologyapi.com/api/v1/gematria`

참고: POST는 GET과 동일한 경로를 사용합니다. /post 접미사가 없습니다.

필수 헤더¶

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

Authorization: Bearer YOUR_API_KEY로도 인증할 수 있습니다. 게마트리아 대시보드에서 API 키를 생성하고 관리합니다.

매개변수¶

매개변수	유형	필수	설명
`text`	문자열	예	어떤 텍스트 (예: `"Hello there"`, `"Love"`).

알파벳 문자만 사용. 히브리어 게마트리아: 히브리 문자(א–ת)만 계산됩니다.

응답을 로컬화하기 위해 선택적인 lang 쿼리 매개변수를 추가합니다. 지원되는 값: en, es, de, fr, pt.## 예시 요청

GET 요청¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/gematria?text=John+Doe&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST 요청 (JSON 본문)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/gematria?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "text": "John Doe"
}'

응답 예시¶

{
  "text": "John Doe",
  "systems": {
    "ordinal": {
      "total": 71,
      "letter_values": [
        {
          "letter": "J",
          "value": 10
        },
        {
          "letter": "o",
          "value": 15
        },
        {
          "letter": "h",
          "value": 8
        },
        {
          "letter": "n",
          "value": 14
        },
        {
          "letter": "D",
          "value": 4
        },
        {
          "letter": "o",
          "value": 15
        },
        {
          "letter": "e",
          "value": 5
        }
      ],
      "interpretation": "Power, abundance, authority, karma, material mastery"
    },
    "reverse_ordinal": {
      "total": 118,
      "letter_values": [
        {
          "letter": "J",
          "value": 17
        },
        {
          "letter": "o",
          "value": 12
        },
        {
          "letter": "h",
          "value": 19
        },
        {
          "letter": "n",
          "value": 13
        },
        {
          "letter": "D",
          "value": 23
        },
        {
          "letter": "o",
          "value": 12
        },
        {
          "letter": "e",
          "value": 22
        }
      ],
      "interpretation": "Creation, leadership, individuality, divine spark, initiation"
    },
    "pythagorean": {
      "total": 35,
      "letter_values": [
        {
          "letter": "J",
          "value": 1
        },
        {
          "letter": "o",
          "value": 6
        },
        {
          "letter": "h",
          "value": 8
        },
        {
          "letter": "n",
          "value": 5
        },
        {
          "letter": "D",
          "value": 4
        },
        {
          "letter": "o",
          "value": 6
        },
        {
          "letter": "e",
          "value": 5
        }
      ],
      "interpretation": "Power, abundance, authority, karma, material mastery"
    },
    "standard_hebrew": {
      "total": 0,
      "letter_values": [],
      "interpretation": "Void, divine source, infinite potential, the unmanifest"
    }
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "0644581355794227",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "gematria",
    "endpoint_description": "Performs Gematria calculations on text, revealing numerical values and meanings.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:29.270421+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": ""
  }
}

셈법 시스템¶

시스템	매핑
순서	A=1, B=2, ..., Z=26
역순서	A=26, B=25, ..., Z=1
피타고라스	A=1, B=2, ..., I=9, J=10, ..., Z=8
히브리어	א=1, ב=2, ..., כ=20, ל=30, ..., ת=400

숨겨진 의미: 순서 값 기반 → interpret_gematria() 검색.

계산 예시¶

"Hello there"
→ letters: H E L L O T H E R E
→ Ordinal: 8+5+12+12+15+20+8+5+18+5 = 108
→ Reverse: 19+22+15+15+12+7+19+22+9+22 = 162
→ Pythagorean: 8+5+3+3+6+2+8+5+9+5 = 54
→ Hebrew: 0 (no Hebrew letters)

대시보드 열기

참고

입력: 모든 문자열 (공백, 구두점, 숫자 무시)
대소문자 구분 없음: 모두 대문자로 변환.
히브리어 지원: 유효한 히브리어 유니코드 문자 (א–ת).
숨겨진 의미:
순서_셈법 기반
검색되지 않으면 "No specific hidden meaning found" 반환
사용 사례:
신성한 이름 분석
신비로운 텍스트 해독
영적 브랜딩
성경/카발라 연구