Après une API de citations de Breaking Bad, puis de Game of Thrones, je me suis attelé à créer une API pour des citations d'une saga que j'adore particulièrement : OSS 117 !
OSS 117, c'est un agent des renseignements, qui fait quelques boulettes. Avant que le grand public ne découvre les aventures de Hubert Bonisseur de La Bath dans une série de films, l'agent a opéré dans plus de 250 livres.
J'ai toujours apprécié l'interprétation au cinéma par Jean Dujardin et les films comportent des tonnes de citations !
A la manière de mes deux petites API précédentes (Breaking Bad Quotes API et Game of Thrones Quotes API), je me suis donc mis à développer une API de citations d'OSS 117. Son nom : OSS 117 Quotes API.
Comme ses cousines, l'API est écrite en Javascript (Node.js) sur la même base. Le code source est évidemment disponible sur Github.
L'API propose plusieurs endpoints :
- Obtenir une citation au hasard
- Obtenir plusieurs citations aléatoires
- Obtenir les citations à partir d'un personnage
- Liste des personnages avec toutes leurs citations
- Détails d'un personnage avec ses citations
Voici quelques exemples.
Pour avoir une citation au hasard :
{
"sentence": "D'accord, faisons comme ça, ravis de t'avoir revu l'ami !",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
}Pour obtenir les citations (deux ici) d'un personnage :
[
{
"sentence": "Moi j'vous dis ça, c'est en tout amitié hein",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
},
{
"sentence": "Mais, ça cuit pas cette connerie là. Mais pourquoi ça cuit pas ?",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
}
]Détail d'un personnage avec ses citations :
[
{
"name": "Bill Trumendous",
"slug": "bill",
"quotes": [
"Sacré Hubert, you are so french.",
"Shut up ! Kiss my ass !",
"Hello m*therf*cker !",
"Comme tu voudras my a*s licking c*ck s*ck*r m*therf*ck**g son of a b**ch",
"You stupid son of a b**ch",
"Raccourcissez-moi cette jupe, vous me donnez chaud"
]
}
]La documentation de l'API est présente sur le site officiel. Egalement, une collection Postman est disponible au téléchargement, afin d'intégrer tous les endpoints de l'API.
