openjung-api（openjung API 文档）

OpenJung API Integration

OpenJung is an open-source personality test based on OEJTS (Open Extended Jungian Type Scales) - a validated 32-question assessment that determines MBTI-compatible personality types.

Base URL: https://openjung.org

Quick Start

Minimal Integration (3 Steps)

// 1. Fetch questions
const { questions } = await fetch('https://openjung.org/api/questions').then(r => r.json());

// 2. Collect user answers (32 questions, values 1-5)
const answers = { "1": 3, "2": 5, /* ... all 32 */ "32": 4 };

// 3. Calculate result
const { result } = await fetch('https://openjung.org/api/calculate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ answers })
}).then(r => r.json());

console.log(result.type); // "ENFP"

API Endpoints

GET /api/questions

Fetch all 32 test questions.

GET /api/questions?locale=en

Response:

{
  "totalQuestions": 32,
  "questions": [
    {
      "id": 1,
      "dimension": "JP",
      "leftTrait": "Makes lists",
      "rightTrait": "Relies on memory"
    }
  ]
}

POST /api/calculate

Calculate personality type from answers.

POST /api/calculate
{
  "answers": { "1": 3, "2": 5, ... "32": 4 },
  "locale": "en",    // optional
  "save": true       // optional - saves to database
}

Response:

{
  "result": {
    "type": "ENFP",
    "scores": { "EI": 18, "SN": 28, "TF": 22, "JP": 32 },
    "percentages": { "E": 75, "I": 25, "S": 12, "N": 88, "T": 31, "F": 69, "J": 0, "P": 100 },
    "typeInfo": {
      "name": "Campaigner",
      "description": "...",
      "strengths": ["..."],
      "weaknesses": ["..."]
    },
    "shareUrl": "https://openjung.org/type/enfp?ei=18&sn=28&tf=22&jp=32"
  },
  "recordId": "uuid"
}

POST /api/record

Record a completed test result (fire-and-forget).

POST /api/record
{
  "answers": { ... },
  "result": { "type": "ENFP", "scores": {...}, "percentages": {...} }
}

GET /api/stats

Get aggregate test statistics.

{
  "totalTests": 15234,
  "typeDistribution": [{ "type": "INFP", "count": 2341 }],
  "localeDistribution": [{ "locale": "en", "count": 8234 }]
}

Scoring System

Scale: 1-5 Likert (1 = strongly left trait, 5 = strongly right trait)

Dimensions (8 questions each):

• EI: Extroversion (E) ↔ Introversion (I)
• SN: Sensing (S) ↔ Intuition (N)
• TF: Thinking (T) ↔ Feeling (F)
• JP: Judging (J) ↔ Perceiving (P)

Score Range: 8-40 per dimension (8 questions × 1-5 scale)

Threshold: 24 (midpoint)

• Score ≤ 24 → left preference (E, S, F, J)
• Score > 24 → right preference (I, N, T, P)

Note: TF dimension is inverted - low score = F (Feeling), high = T (Thinking)

Question Mapping

Localization

44 languages supported. Pass locale parameter to endpoints:

• en (English), zh (Simplified Chinese), ja (Japanese), ko (Korean)
• es (Spanish), fr (French), de (German), pt (Portuguese)
• And 36 more...

Error Handling

Resources

For detailed API specifications and TypeScript types, see references/api_reference.md.