#OQDB

Le projet OpenQuizzDB fournit une API JSON gratuite destinée aux développeurs de logiciels. Pour l'utiliser, vous devez être familiarisé(e) avec la programmation Web et être à l'aise pour créer des applications qui consomment des services Web via des requêtes HTTP.

Déjà 7 953 224 requêtes API distribuées par nos serveurs.

L'utilisation de cette API requiert une clé. Une fois votre clé API reçue, générez simplement l'URL dans votre application avec les paramètres adéquats pour retrouver les questions.

Toutes les données fournies par l'API sont disponibles sous licence Creative Commons Attribution-ShareAlike 4.0 International.  

 DOCUMENTATION API
La documentation API est disponible au format web (voir ci-dessous) ou au format PDF.
La version 1.7 est la version actuelle de notre API.

 EXEMPLE D'URL À UTILISER

 CLÉ API
Une clé API est une clé unique qui aide à garder une trace des questions que l'API a déjà pu retrouver pour vous. En ajoutant une clé API dans votre appel, l'API ne vous enverra jamais deux fois la même question (sauf si demandé comme tel). Un appel API sans clé valide renverra un code réponse 3 (voir plus loin pour la liste des codes réponse).

Une clé API reste valable aussi longtemps que son utilisation n'outrepasse pas les règles en vigueur.

Une seule clé sera fournie par adresse e-mail. Veillez donc à ne pas la perdre, sans quoi les demandes API ne pourront plus être correctement effectuées.

 OBTENIR MA CLÉ API
Pour recevoir votre clé API unique, remplissez le formulaire ci-dessous. Une fois l'adresse e-mail vérifiée, votre clé API vous sera expédiée dans les minutes qui suivent. Vous pourrez ainsi commencer à l'utiliser de suite.





 CLÉ API PREMIUM
En plus de son contenu exceptionnel, notre Pack Découverte contient également une clé API PREMIUM vous permettant d'exécuter autant d'appels API que vous le souhaitez, sans aucune restriction ni limitation, et ce pour une durée de six mois.

Une clé API PREMIUM s'utilise exactement de la même manière qu'une clé API standard.

 CODES RÉPONSE
L'API renvoie un "code réponse" à chaque appel pour aider les développeurs à savoir ce que l'API a fait.

  • Code 0 : Succès Renvoie les résultats demandés.

  • Code 1 : Pas de résultats Ne peut pas renvoyer de résultats. L'API n'a pas assez de questions pour votre requête. (Ex. demande de 30 questions dans une catégorie qui n'en contient plus que 20)

  • Code 2 : Paramètre manquant ou invalide Ne contient pas suffisamment de paramètres ou contient un paramètre invalide. Les arguments passés ne sont pas valides (Ex. amount=dix)

  • Code 3 : Clé API non trouvée La clé API n'existe pas ou n'est plus valide.

  • Code 4 : Clé API déjà utilisée aujourd'hui Un appel (avec code réponse 0) a déjà été effectué aujourd'hui avec cette clé ou depuis le même ordinateur. Il vous faudra attendre le lendemain pour effectuer un nouvel appel ou disposer d'une clé API PREMIUM.

  • Code 5 : Adresse e-mail non joignable Adresse e-mail valide mais non joignable au moment de l'appel.

  • Code 6 : Plus de données Toutes les questions pour la requête demandée ont déjà été envoyées. Dans ce cas, utiliser le paramètre repeat, parcourir une autre catégorie ou attendre les nouvelles publications.

  • Code 7 : Clé API PREMIUM expirée La clé API PREMIUM est arrivée à expiration. Demander une nouvelle clé PREMIUM via le dernier Pack Découverte.

 PARAMÈTRES
Afin de plus facilement cibler le contenu que vous souhaitez obtenir via notre API, des paramètres peuvent être utilisés lors de vos appels.

  • key : votre clé API personnelle, standard ou PREMIUM.
    Ce paramètre est requis lors de chaque appel API.

  • lang : langue de retour à utiliser (fr, en, es, it, de, nl).
    Valeur par défaut : français

  • amount : nombre de quizz à renvoyer pour cet appel (1 à 30).
    Valeur par défaut : 1

  • choice : nombre de propositions de réponse à renvoyer (1, 2, 3, 4).
    Valeur par défaut : 4

  • categ : catégorie à parcourir (voir ci-dessous).
    Valeur par défaut : toutes les catégories

  • diff : niveau de difficulté (1, 2, 3).
    Valeur par défaut : toutes les difficultés

  • anec : inclure une anecdote permettant d'apporter un complément d'information instructif à la question posée (0, 1).
    Valeur par défaut : non (0)

  • wiki : inclure le lien Wikipédia relatif à la question posée (0, 1).
    Valeur par défaut : non (0)

  • repeat : permet de spécifier si l’on souhaite récupérer du contenu déjà envoyé par l’API (0, 1).
    Valeur par défaut : non (0)

 CATÉGORIES
La liste des catégories reprises dans notre API est la suivante :

  • adultes
  • animaux
  • archeologie
  • arts
  • bd
  • celebrites
  • cinema
  • culture
  • gastronomie
  • geographie
  • histoire
  • informatique
  • internet
  • litterature
  • loisirs
  • monde
  • musique
  • nature
  • quotidien
  • sciences
  • sports
  • television
  • tourisme

 LIMITATIONS
  • Une seule catégorie peut être spécifiée par appel API. Pour recevoir des questions de toutes les catégories, ne spécifiez pas de catégorie.
  • Un maximum de 30 questions peut être retrouvé par appel.
  • Un seul appel (avec un code réponse 0) peut être effectué par jour, excepté pour une clé API PREMIUM.

 GÉNÉRATEUR D'URL
Cet outil vous aidera à générer dans votre code une URL contenant les paramètres adéquats.

Votre clé API * :

Nombre de questions :

Langue :

Nombre de choix :

Choisissez une catégorie :

Choisissez une difficulté :

Inclure une anecdote:

Inclure un lien Wikipédia:

Autoriser la répétition de contenu:

* paramètre obligatoire