La problématique
Aujourd'hui, nous allons voir une API qui se raporte à la confession chrétienne. Si vous connaissez des API liées à d'autres confessions, je reste interessé, vous pouvez m'en faire part par le formulaire de contact.
Pour résumer, dans la bible, y'a des évangiles (appelés des livres dans cette API, si j'ai bien compris), des chapitres, des versets et des apôtres. En miixant tout ça, nous pouvons en sortir le verset souhaité, il n'ya qu'a l'appeler.
Le service interrogé :
Le service possède une documentation bien expliquée, mais sa présentation laisse à désirer à mon goût. Cepndant, on y comprend que l'appel se fait de la manière suivante :
Détaillons désormais les paramètres :
- http://ibibles.net/quote.php : nom du service
- xxx : Version de la Bible. Il peut être en minuscules ou en majuscules ou mixte.
- yyy : Livre de la Bible comme celui ci-dessous. Il peut être en minuscules ou en majuscules ou mixte
Une exception est "Philémon" qui a besoin d'au moins 5 caractères, sinon il sera confondu avec "Philippiens" - aa : Numéro de départ d'un chapitre
- bb : Numéro de départ d'un verset
- cc : Numéro de fin d'un fin chapitre. Il peut être omis s'il est le même que le départ chapitre. Le format est de la forme "aa:bb-dd"
- dd : Numéro de fin d'un verset. Il peut être omis s'il n'y a qu'un seul verset. Le format est de la forme "aa:bb"
Codes de l'exemple :
Nous allons voir ici quelques exemples commentés
Recherchons le premier verset de la bible selon Mathieu, chapitre 5, verset 3 à verset 12 (attention, dans la bible, le dernier verset n'est pas le 12 mais le 5, remarquez qu'il n'y a aucune erreur !) : http://ibibles.net/quote.php?lsg-mat/5:3-5-12
Le résultat :