Aller au contenu
Accueil » API publique

API publique

La Bible en breton

L’API publique de Bibl.bzh permet de consulter le catalogue des livres et de récupérer le texte breton d’un chapitre. Les requêtes utilisent la méthode GET et les réponses sont au format JSON. L’accès est libre, sans clé API.

Adresse de base : https://bibl.bzh/wp-json/bibl/v1

RouteRéponseExemple
/levrCatalogue dans l’ordre du site : Ancien Testament, Nouveau Testament, puis Psaumes. Pour chaque livre, l’API fournit son code, ses titres en breton et en français, et les chapitres disponibles dans pennadou.Voir le catalogue
/levr/{levr}/pennad/{pennad}Texte du chapitre demandé. Le champ yezh vaut br (seule langue retournée à l’heure actuelle). Chaque entrée de gwerzadou contient le numéro affiché du chapitre (pennad), la référence du verset (gwerzad) et son texte (testenn). Les versets sont déjà triés et doivent être affichés dans l’ordre donné en réponse.Voir Luc 1

Pour ouvrir un chapitre, utilise le code du livre et un numéro de la liste pennadou. Certains livres ont un chapitre 0, comme la Lettre de Jérémie. Le champ gwerzad est une chaîne de caractères afin de conserver les références comme 6a.

Un chapitre introuvable renvoie le statut HTTP 404 avec le code bibl_pennad_not_found. Une erreur de base de données renvoie le statut 500 avec le code bibl_database_error. Les messages de l’API sont en breton. Les réponses publiques peuvent être mises en cache jusqu’à 24 heures.

Lectures des dimanches et jours de fête

L’API publique de Bibl.bzh donne également accès aux lectures liturgiques en breton et au podcast Pedenn an deiz lorsqu’un épisode est disponible. Les requêtes utilisent la méthode GET et renvoient du JSON. Aucune clé API n’est requise.

Les routes ci-dessous s’ajoutent à l’adresse https://bibl.bzh/wp-json/bibl/v1.

RouteRésultatExemple
/lennadennou/{AAAA-MM-JJ}Les lectures et le podcast de la date demandée, selon leur disponibilité.14 juin 2026
/lennadennou/hizivLes lectures et le podcast du jour, selon l’heure de Paris.Aujourd’hui
/lennadennou/kentanLes lectures du jour ou, à défaut, celles de la prochaine fête ou du prochain dimanche. Le podcast reste celui du jour.Prochaines lectures

Comprendre la réponse

  • deiziad indique la date demandée. deiziad_lennadennou indique la date des textes renvoyés, ou vaut null si aucun texte n’est disponible.
  • lennadennou regroupe les lectures par messe. Chaque messe contient ses textes dans testennou, dans l’ordre d’affichage du site.
  • aodio contient le lien du podcast et sa propre date dans aodio.deiziad. Il vaut null si aucun épisode n’est disponible.
  • liamm_web ouvre la page des lectures sur Bibl.bzh. Le lien utilise la date des textes renvoyés ou, en leur absence, la date demandée.
  • deiziad_da_heul et liamm_da_heul donnent la date de la prochaine célébration prévue et le lien vers sa réponse JSON.

Une date valide sans lectures renvoie un statut HTTP 200 avec une liste lennadennou vide. Le podcast est fourni s’il existe. Une date invalide, par exemple 2026-02-30, renvoie un statut HTTP 400.