API Documentation

Complete guide voor het gebruik van de Vraag het Wander API

Quick Start

Snel aan de slag met de API

Single Word (GET):

GET /api/check?woord=gezellig

Multiple Words (GET):

GET /api/check?woorden=gezellig,kanker,mooi

Single Word (POST):

POST /api/check {"woord": "lekker"}

Multiple Words (POST):

POST /api/check {"woorden": ["lekker", "shit", "mooi"]}

Endpoint Details

Alle details over de /api/check endpoint

Base URL

https://vraaghetwander.mbvanderleest.nl/api/check

Methods

GETSingle word: ?woord=your_word

GETMultiple words: ?woorden=word1,word2,word3

POSTSingle word: {"woord": "your_word"}

POSTMultiple words: {"woorden": ["word1", "word2", "word3"]}

Response Format

Single Word Response:

{
  "woord": "gezellig",
  "status": "approved|rejected|unknown",
  "message": "Het woord "gezellig" wordt gewandeerd!",
  "gewandeerd": true
}

Multiple Words Response:

{
  "woorden": ["gezellig", "kanker", "mooi"],
  "results": [
    {
      "woord": "gezellig",
      "status": "approved",
      "message": "Het woord "gezellig" wordt gewandeerd!",
      "gewandeerd": true
    },
    {
      "woord": "kanker", 
      "status": "rejected",
      "message": "Het woord "kanker" bevat scheldwoorden en wordt niet gewandeerd!",
      "gewandeerd": false
    },
    {
      "woord": "mooi",
      "status": "approved", 
      "message": "Het woord "mooi" wordt gewandeerd!",
      "gewandeerd": true
    }
  ],
  "total": 3,
  "approved": 2,
  "rejected": 1,
  "unknown": 0
}

Response Examples

Voorbeelden van verschillende API responses

ApprovedGewandeerd woord

{
  "woord": "gezellig",
  "status": "approved",
  "message": "Het woord "gezellig" wordt gewandeerd!",
  "gewandeerd": true
}

RejectedNiet gewandeerd woord

{
  "woord": "kanker",
  "status": "rejected",
  "message": "Het woord "kanker" bevat scheldwoorden en wordt niet gewandeerd!",
  "gewandeerd": false
}

UnknownOnbekend woord

{
  "woord": "onbekendwoord",
  "status": "unknown",
  "message": "Het woord "onbekendwoord" is nog nooit gevraagd. Vraag het Wander!",
  "gewandeerd": false
}

Code Examples

Praktische voorbeelden voor verschillende talen en platforms

JavaScript (Fetch)

// Single word GET request
const response = await fetch('/api/check?woord=gezellig');
const data = await response.json();
console.log(data);

// Multiple words GET request
const response = await fetch('/api/check?woorden=gezellig,kanker,mooi');
const data = await response.json();
console.log(data);

// Single word POST request
const response = await fetch('/api/check', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ woord: 'lekker' })
});
const data = await response.json();
console.log(data);

// Multiple words POST request
const response = await fetch('/api/check', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ woorden: ['lekker', 'shit', 'mooi'] })
});
const data = await response.json();
console.log(data);

cURL

# Single word GET request
curl "https://vraaghetwander.mbvanderleest.nl/api/check?woord=gezellig"

# Multiple words GET request
curl "https://vraaghetwander.mbvanderleest.nl/api/check?woorden=gezellig,kanker,mooi"

# Single word POST request
curl -X POST "https://vraaghetwander.mbvanderleest.nl/api/check" \
  -H "Content-Type: application/json" \
  -d '{"woord": "lekker"}'

# Multiple words POST request
curl -X POST "https://vraaghetwander.mbvanderleest.nl/api/check" \
  -H "Content-Type: application/json" \
  -d '{"woorden": ["lekker", "shit", "mooi"]}'

Error Handling

Hoe om te gaan met fouten en edge cases

Missing Parameter

{
  "error": "Missing woord parameter",
  "usage": "Use: /api/check?woord=your_word_here"
}

Invalid JSON

{
  "error": "Invalid JSON in request body"
}

Gemaakt met liefde voor Wander door mbvanderleest