API Documentation

GET: /api/{type}/challenge/{id}

Description: Get a specific challenge by ID. Perfect for displaying individual challenges.

Parameters:

• {type} - Challenge type: html, css, or js
• {id} - Challenge ID (integer)

Example:

// Fetches Challenge 1 in our HTML program.
const response = await fetch(
  'https://efiwe.com/api/api.php/api/html/challenge/1'
);
const challenge = await response.json();
console.log(challenge);
// Returns:
// {
// id: 1,
// topic: "Document Type Declaration",
// difficulty: "easy",
// introduction: "<p>HTML stands for HyperText Markup Language, and it's the fundamental building block of every website on the internet...",
// description: "Using the code example above, write the...",
// hints: ["Start with <!DOCTYPE and end with >."],
// explanation: "The doctype declaration tells the browser what type of document to expect."
// }

POST: /api/{type}/validate

Description: Validate user's code submission. Returns Efiwe 1.0 AI-powered diagnostics and feedback. The mode parameter adjusts the similarity threshold: 'easy' (70%), 'intermediate' (80%), 'difficult' (90%), 'master' (100%). Default mode is AI-driven and adjusts based on user's error count (starts at 100%, lowers after repeated errors).

Parameters:

• {type} - Challenge type: html, css, or js

Request Body:

// Sample user code submission
{
  "id": 1,
  "code": "<p>Hello World</p>",
  "mode": "default"
}

Example:

// Update the program shortcode as needed.
const response = await fetch(
  'https://efiwe.com/api/api.php/api/html/validate',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      id: 1,
      code: '<p>Hello World</p>',
      mode: 'default'
    })
  }
);
const result = await response.json();
console.log(result);
// Returns:
// {
correct: true,
// feedback: "Great job!",
// diagnostics: []
// }

POST: /api/{type}/ai-feedback

Description: Get Efiwe 2.0 AI-powered feedback on user's code submission. Provides a short sentence of analysis. If AI is unavailable, falls back to pre-programmed responses. Responses are limited to 15 words maximum. The system rotates through multiple AI models for reliability.

Parameters:

• {type} - Challenge type: html, css, or js

Request Body:

{
  "id": 1,
  "code": "<p>Hello World</p>"
}

Example:

const response = await fetch(
  'https://efiwe.com/api/api.php/api/html/ai-feedback',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      id: 1,
      code: '<p>Hello World</p>'
    })
  }
);
const result = await response.json();
console.log(result);
// Returns:
// {
// feedback: "Correct! Your paragraph tag is properly opened and closed."
// }

POST: /api/{type}/ai-hint

Description: Request Efiwe 2.0 AI-generated hints for a specific challenge. Provides a short sentence of guidance. If AI is unavailable, falls back to pre-programmed hints. Responses are limited to 15 words maximum. The system rotates through multiple AI models for reliability.

Parameters:

• {type} - Challenge type: html, css, or js

Request Body:

{
  "id": 1,
  "code": "<p Hello World</p>"
}

Example:

const response = await fetch(
  'https://efiwe.com/api/api.php/api/html/ai-hint',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      id: 1,
      code: '<p Hello World</p>'
    })
  }
);
const result = await response.json();
console.log(result);
// Returns:
// {
// hint: "Remember that HTML tags need opening and closing brackets."
// }

POST: /api/{type}/ai-diagnose

Description: Get Efiwe 2.0 AI-powered diagnostics for incorrect code submissions. Returns an array of issues with solutions. If AI is unavailable, falls back to pre-programmed diagnostics. The system rotates through multiple AI models for reliability.

Parameters:

• {type} - Challenge type: html, css, or js

Request Body:

{
  "id": 1,
  "code": "<p>Hello World"
}

Example:

const response = await fetch(
  'https://efiwe.com/api/api.php/api/html/ai-diagnose',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      id: 1,
      code: '<p>Hello World'
    })
  }
);
const result = await response.json();
console.log(result);
// Returns:
// {
// diagnostics: [
// {
// issue: "Missing closing tag",
// solution: "Add </p> to close the paragraph tag"
// }
// ]
// }