NOBLEME
DISCUTER
LIRE
JOUER
EN
Afficher le menu latéral

API publique de NoBleme

Pour les développeurs qui veulent aller plus loin avec le site

NoBleme possède une API publique, c'est à dire une façon d'envoyer des demandes à NoBleme.com auxquelles il répond dans un format standardisé. Cela permet à des programmes ou applications externes d'utiliser des données en provenance NoBleme sans avoir à trop se compliquer la vie. Cette page s'adresse aux développeurs qui savent ce qu'ils font : si vous ne comprenez pas ce qu'est une API, c'est que vous ne tirerez probablement rien d'utile de cette page.

L'API de NoBleme est en lecture seule, c'est à dire que vous pouvez lui demander de lister des contenus qui se trouvent sur le site, mais vous ne pouvez pas lui demander de modifier ou supprimer des contenus du site. De plus, c'est une API publique, cela signifie que vous n'avez pas à vous authentifier pour demander des données à l'API, mais aussi que cette API est limitée aux données publiques - vous ne pouvez pas lui demander des données privées liées à votre compte.

Ci-dessous, vous trouverez une documentation complète des sections du site auxquelles vous pouvez faire des requêtes à partir de l'API publique de NoBleme, accompagnée d'exemples. Les données renvoyées par les requêtes sont sous forme d'un tableau d'objets JSON. Si une requête ne renvoie aucun résultat, elle renverra une erreur 404 au lieu de renvoyer un tableau d'objets JSON.






Encyclopedie de la culture web

https://nobleme.com/api/v1/nbdb


Données renvoyées :

Les données sont renvoyées triées par titre, dans l'ordre alphabétique.


CHAMP TYPE CONTENU
uuid ID Un identifiant unique, sans rapport avec la page
type STRING Type de page ('encyclopedia' ou 'dictionary' de la culture internet)
url STRING URL à laquelle se trouve la page
shorturl STRING Version courte de l'URL à laquelle se trouve la page
title STRING Titre de la page
contents STRING Contenu de la page


Paramètres possibles :

PARAMÈTRE IMPORTANCE DESCRIPTION
lang={string} Optionnel Renvoie les pages dans une langue spécifique ('FR' ou 'EN') - en anglais par défaut
type={string} Optionnel Renvoie les pages d'un type spécifique ('encyclopedia' ou 'dictionary' ou 'both')
title={string} Optionnel Renvoie les titres contenant une chaîne de caractères spécifique
search={string} Optionnel Renvoie les pages dont le contenu contient une chaîne de caractères spécifique


Exemples d'utilisation :

https://nobleme.com/api/v1/nbdb - Renvoie toutes les pages
https://nobleme.com/api/v1/nbdb?lang=FR - Renvoie toutes les pages, en français
https://nobleme.com/api/v1/nbdb?lang=EN&type=dictionary - Renvoie toutes les pages du dico de la culture web, en anglais
https://nobleme.com/api/v1/nbdb?title=hog&search=cochonou - Les pages ayant 'hog' dans le titre et contenant 'cochonou'






Miscellanées (citations)

https://nobleme.com/api/v1/quotes


Données renvoyées :

Les données sont renvoyées triées par timestamp, par ordre antéchronologique (du plus récent au plus ancien).


CHAMP TYPE CONTENU
id INT ID unique de la citation
url STRING URL à laquelle se trouve la citation
shorturl STRING Version courte de l'URL à laquelle se trouve la citation
timestamp INT Date d'ajout de la citation, sous forme d'un timestamp UNIX
lang STRING Langue de la citation
text STRING Contenu de la citation
nsfw BOOL Si true, la citation est NSFW (contient du contenu vulgaire ou sensible)


Paramètres possibles :

PARAMÈTRE IMPORTANCE DESCRIPTION
id={int} Optionnel Renvoie une citation spécifique
lang={string} Optionnel Renvoie les citations dans une langue spécifique ('FR' ou 'EN')
search={string} Optionnel Renvoie les citations contenant la chaîne de caractères


Exemples d'utilisation :

https://nobleme.com/api/v1/quotes - Renvoie toutes les miscellanées
https://nobleme.com/api/v1/quotes?id=14 - Renvoie uniquement la miscellanée #14
https://nobleme.com/api/v1/quotes?lang=FR&search=Paris - Renvoie les miscellanées en français contenant "Paris"