API - Questions

Récupérez les questions

Cet endpoint vous permet de récupérer les questions de quiz disponibles. Cet outil est idéal pour les intégrations, les applications personnalisées, jeux ou toute utilisation nécessitant un accès dynamique à des questions de quiz.

# Endpoint

URL: /api/questions
Méthode HTTP: GET
Description: Récupère une liste de questions de quiz, filtrées selon les paramètres optionnels fournis.

GET /api/questions
Authorization: Bearer [your-access-token]
Accept: application/json
Content-Type: application/json

# Exemple de Réponse

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": [
    {
      "id": "01jd02ymxezhavpcwzr81qs9q1",
      "type": "multi",
      "title": {
        "fr": "Quelle est la capitale du Royaume-Uni ?"
        "en": "What is the capital of the United Kingdom ?"
      },
      "description": "",
      "difficulty": 1,
      "theme": {
        "title": "Culture Générale",
        "code": "cg"
      },
      "answers": [
        {
          "id": "01JD02YMXB30QZF67QVEE2765A",
          "title": {
            "fr": "Londres",
            "en": "London"
          },
          "isValid": true
        },
        {
          "id": "01JD02YMXB30QZF67QVEE2765B",
          "title": {
            "fr": "Paris",
            "en": "Paris"
          },
          "isValid": false
        },
      ]
    }
  ]
}

Assurez-vous d'inclure un jeton d'authentification valide dans l'en-tête Authorization pour accéder à cet endpoint.

# Paramètres

# Types

Par défaut, la requête vous renvoit tous les types de questions disponibles. Vous pouvez cependant filtrer pour obtenir uniquement les types dont vous avez besoin.

Par exemple, si vous désirez uniquement les question de type "choix", il faudra spécifier le paramètre types dans la requête GET

GET /api/questions?types=solo,multi

Paramètre	Valeurs	Multiple Plusieurs paramètres peuvent être passé séparés de ","
types	mono,multi,pattern

# Difficultés

Vous pouvez filtrer les questions par difficultés.

GET /api/questions?difficulty=1

Paramètre	Valeurs	Multiple Plusieurs paramètres peuvent être passé séparés de ","
difficulty	1,2,3,4,5,6

# Thèmes

Vous pouvez restreindre les questions aux thèmes inclus en paramètres.

GET /api/questions?themes=cg,geo

Paramètre	Valeurs	Multiple Plusieurs paramètres peuvent être passé séparés de ","
themes	Codes Thèmes

# Limites

Vous pouvez spécifier le nombre de questions retournées.

GET /api/questions?limit=3

Paramètre	Valeurs	Multiple Plusieurs paramètres peuvent être passé séparés de ","
limit	number

# Langues

Vous pouvez inclure plusieurs traductions aux questions retournées.

Par défaut, sans paramètres, la question sera retournée uniquement dans la langue paramétrée sur l'interface de Quiz API.

GET /api/questions?langs=fr,en

Paramètre	Valeurs	Multiple Plusieurs paramètres peuvent être passé séparés de ","
langs	fr,en