WikiForms API

const popup = window.open(
  'https://wikiforms.toolforge.org/api/auth/mediawiki',
  'WikiForms Login',
  'width=600,height=600,popup=1'
);

window.addEventListener('message', (e) => {
  if (e.data.type === 'WIKI_AUTH_SUCCESS') {
    const { username, auth_token } = e.data.user;
    // Store token — send as X-WF-Token on all protected requests
    localStorage.setItem('wf_user', JSON.stringify(e.data.user));
  }
});

headers: {
  'Content-Type': 'application/json',
  'X-WF-Token': user.auth_token
}

const data = await fetch('/api/auth/me').then(r => r.json());
// Logged in:  { status: 'success', username: 'Anaf' }
// Logged out: { status: 'guest' }

const res = await fetch('/api/save-form', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-WF-Token': token
  },
  body: JSON.stringify({
    slug: 'bangladesh-history-quiz',
    contentType: 'quiz',
    title: 'Bangladesh History Quiz',
    description: 'Test your knowledge of Bangladesh history.',
    questions: [
      {
        id: 'q1', type: 'radio', required: true,
        text: 'When did Bangladesh gain independence?',
        options: ['1971', '1947', '1952', '1965'],
        correctAnswer: '1971', points: 10,
        successMsg: 'Correct! March 26, 1971.',
        failMsg: 'Bangladesh declared independence on March 26, 1971.'
      },
      {
        id: 'q2', type: 'text', required: true,
        text: 'Who is known as the Father of the Nation of Bangladesh?',
        correctAnswer: 'Sheikh Mujibur Rahman', points: 10
      }
    ],
    timer_type: 'static', timer_duration: 30,
    result_timing: 'instant'
  })
});
// → { status: 'success' }

const form = await fetch('/api/get-form/bangladesh-history-quiz')
  .then(r => r.json());

/*
{
  id: 'bangladesh-history-quiz',
  contentType: 'quiz',
  title: 'Bangladesh History Quiz',
  description: 'Test your knowledge...',
  cover_image: null,
  owner_username: 'Anaf',
  collaborators: [],
  timer_type: 'static',
  timer_duration: 30,
  timer_start: null,
  timer_end: null,
  timer_before_msg: {},
  timer_after_msg: {},
  result_timing: 'instant'
}
*/

const data = await fetch(`/api/get-form-questions/${slug}`, {
  method: 'POST'
}).then(r => r.json());
// { status: 'success', questions: [ ...questions without correctAnswer ] }

const data = await fetch('/api/my-forms/Anaf', {
  headers: { 'X-WF-Token': token }
}).then(r => r.json());

/*
{
  status: 'success',
  forms: [{
    slug: 'bangladesh-history-quiz',
    title: 'Bangladesh History Quiz',
    content_type: 'quiz',
    owner_username: 'Anaf',
    collaborators: ['OtherUser'],
    timer_type: 'static',
    response_count: 42,
    recent_dates: ['2026-07-05T10:00:00', ...],  // last 30 responses
    created_at: '2026-06-01T00:00:00',
    updated_at: '2026-07-05T00:00:00'
  }]
}
*/

const res = await fetch('/api/save-response', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    form_slug: 'bangladesh-history-quiz',
    title: 'Bangladesh History Quiz',
    type: 'quiz',
    answers: {
      q1: '1971',
      q2: 'Sheikh Mujibur Rahman',
      '__email__': 'user@example.com'  // optional
    }
  })
});
const data = await res.json();

const data = await fetch('/api/get-responses/bangladesh-history-quiz', {
  headers: { 'X-WF-Token': token }
}).then(r => r.json());

/*
{
  status: 'success',
  responses: [{
    id: 1,
    answers: { q1: '1971', q2: 'Sheikh Mujibur Rahman' },
    timestamp: '2026-07-05 10:00:00'
  }]
}
*/

const res = await fetch('/api/grade-response', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    questions: [{
      id: 'q1',
      question: 'What is the capital of Bangladesh?',
      correctAnswer: 'Dhaka',
      userAnswer: 'the capital city is Dhaka'
    }]
  })
});
const data = await res.json();
// { status: 'success', results: [{ id: 'q1', correct: true }] }

const data = await fetch('/api/quiz/start', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ form_slug: 'my-quiz', username: 'Anaf' })
}).then(r => r.json());
// { status: 'success', session_id: '64-char-hex', deadline: '2026-07-05T10:30:00Z' }

const interval = setInterval(async () => {
  const res = await fetch('/api/quiz/heartbeat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ session_id: sessionId })
  }).then(r => r.json());

  if (res.status === 'terminated') {
    clearInterval(interval);
    // Lock the quiz UI
  }
  // { status: 'alive', server_ts: '2026-07-05T10:15:03Z' }
  // { status: 'terminated', reason: 'heartbeat_missed' | 'deadline_exceeded' }
}, 3000);

const validation = await fetch('/api/quiz/validate-session', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ session_id: sessionId, form_slug: slug })
}).then(r => r.json());

if (validation.status === 'terminated') {
  // reject submission
} else if (validation.status === 'valid') {
  // proceed to save-response
}

await fetch('/api/add-collaborator', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-WF-Token': token },
  body: JSON.stringify({
    slug: 'my-quiz',
    new_collaborator: 'AnotherWikipediaUser'
  })
});
// → { status: 'success' }

await fetch('/api/remove-collaborator', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-WF-Token': token },
  body: JSON.stringify({ slug: 'my-quiz', collaborator: 'AnotherWikipediaUser' })
});
// → { status: 'success' }

// List available languages with coverage percentages
const langs = await fetch('/api/usr-lang').then(r => r.json());
// { languages: [{ code: 'bn', name: 'বাংলা', live_count: 97, coverage: 100 }] }

// Get Bengali translations
const bn = await fetch('/api/usr-lang/bn').then(r => r.json());
/*
{
  status: 'success', lang: 'bn',
  keys: { app_name: 'উইকিফর্মস', welcome_title: 'উইকিফর্মে আপনাকে স্বাগত!', ... }
}
*/

await fetch('/api/editor', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-WF-Token': token },
  body: JSON.stringify({
    lang_code: 'de',
    lang_name: 'Deutsch',
    translation_key: 'welcome_title',
    value: 'Willkommen bei WikiForms!'
  })
});
// → { status: 'success', message: 'Translation saved as draft.' }

await fetch('/api/publisher', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-WF-Token': token },
  body: JSON.stringify({
    lang_code: 'de',
    translation_key: 'welcome_title'
  })
});
// → { status: 'success', message: 'Translation published.' }

const data = await fetch('/api/test-connection').then(r => r.json());
// { status: 'success', message: 'Connected!' }