Une API de répliques d'OSS 117 ? Habile !
🌐 Site et démo : https://oss117quotes.xyz/
➡ https://api.oss117quotes.xyz
Obtenir une citation au hasard :
{
"sentence": "Je ne vois pas trop l'intérêt de ressembler à une femme.",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
}
Retourne {number} citations de manière aléatoire.
Le paramètre number est facultatif. Par défaut, une seule citation est retournée.
[
{
"sentence": "23-0 ! C'est la piquette Jack !!! Tu sais pas jouer, Jack ! T'es mauvais hahahahaha !!!",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
},
{
"sentence": "Bien, mais dépêchons-nous, je n'ai que quelques heures.",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
},
{
"sentence": "Pour rencontrer M. Li, il vaut mieux avoir une bonne couverture, sinon, je serai dans de beaux draps.",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
}
]
Retourne les citations d'un personnage.
Plus d'informations sur le paramètre character plus bas.
Le paramètre number est facultatif. Par défaut, toutes les citations du personnage sont retournées.
[
{
"sentence": "Ah ah bravo Bill, en plein dans l'dos !",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
},
{
"sentence": "Fonce, Slimane ! Fooonce !!!",
"character": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert"
}
}
]
Retourne la liste des personnages avec leurs citations.
[
{
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert",
"quotes": [
"En tout cas, on peut dire que le Soviet éponge !",
"Ça fait un peu Jacadi a dit : « Pas de charcuterie ! »",
"J'aime le bruit blanc de l'eau."
]
},
{
"name": "Bill Tremendous",
"slug": "bill",
"quotes": [
"Shut up ! Kiss my ass !"
]
}
]
Retourne le détail d'un personnage.
Le paramètre name est le diminutif du personnage (voir plus bas pour plus d'information).
[
{
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)",
"slug": "hubert",
"quotes": [
"En tout cas, on peut dire que le Soviet éponge !",
"Ça fait un peu Jacadi a dit : « Pas de charcuterie ! »",
"J'aime le bruit blanc de l'eau."
]
}
]
Le diminutif d'un personnage est présent dans l'entrée "slug".
Vous pouvez aussi les retrouver dans le fichier datas.json :
"characters": {
"hubert": {
"name": "Hubert Bonnisseur de La Bath (alias OSS 117)"
},
"carlotta": {
"name": "Carlotta"
},
"larmina": {
"name": "Larmina El Akmar Betouche"
},
"zimmel": {
"name": "Von Zimmel"
},
"moeller": {
"name": "Gerhard Moeller"
},
"bill": {
"name": "Bill Tremendous"
},
"raymond": {
"name": "Raymond Pelletier"
},
"dolores": {
"name": "Dolorès"
}
...
},
Les diminutifs sont donc : hubert, carlotta, larmina, etc...
Vous pouvez intégrer l'API dans Postman grâce à la collection Postman disponible sur le dépôt.
Vous pouvez trouver le Dockerfile ici et sur Docker Hub.
Si vous souhaitez ajouter une ou plusieurs citations, suivez les étapes suivantes.
- Fork le projet en cliquant sur le bouton "Fork" en haut à droite de cette page
- Cloner le dépôt (git clone) sur votre machine
- Ouvrir le fichier
datas.json - S'assurer que la citation n'existe pas déjà
- S'assurer que le personnage existe bien dans la partie "characters"
- Commit et push les modifications
- Faire un pull request
Merci !