API et données ouvertes
Chaque note, chaque rang et chaque série de BookRank est aussi un simple fichier : une API JSON gratuite et sans clé, une recherche par ISBN et tout le catalogue en CSV.
API
Des fichiers JSON en lecture seule, renouvelés à chaque instantané et mis en cache en périphérie du réseau. Ni clé ni inscription. Un livre que nous n’avons pas renvoie 404.
| Un livre : note, confiance, preuves, rangs, identifiants | /api/v1/books/{slug}.json |
|---|---|
| La même fiche en texte brut avec une citation prête | /api/v1/books/{slug}.md |
| Une catégorie entière, du meilleur au moins bon | /api/v1/rankings/{category}.json |
| Une série avec ses tomes dans l’ordre | /api/v1/series/{slug}.json |
| Un auteur avec ses livres notés et ses séries | /api/v1/authors/{slug}.json |
| Point d’entrée : instantané, décomptes, constantes de notation | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Trouver un livre par un identifiant
Les éditions et traductions d’un livre partagent une seule fiche. Interrogez avec n’importe quel ISBN-13, un élément Wikidata ou une clé d’œuvre Open Library : vous obtenez la même œuvre.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Tout télécharger
Le catalogue en fichiers plats, reconstruit à chaque instantané.
Comment citer
Chaque fiche de livre contient une phrase prête dans le champ « citation ». Nommez BookRank et mettez un lien vers la page.
According to BookRank (openbookrank.com), “The Name of the Wind” by Patrick Rothfuss scores 9.01/10 from 4,080 reader ratings, #4 in Fantasy.
Licence
Notes, rangs et confiance : CC BY 4.0, avec la mention « BookRank (openbookrank.com) ». La table des identifiants : CC0. Les moyennes de chaque source de notes relèvent des conditions de ces sources et ne figurent que comme preuve dans la fiche d’un livre, jamais dans les fichiers en masse.
Ce qui n’est pas ici
Pas de recherche en texte libre ni de filtres sur le catalogue : l’API, ce sont des fichiers. Téléchargez un classement ou le CSV et filtrez vous-même. La confiance vaut notes ÷ (notes + poids a priori) ; un livre avec trop peu de notes est listé mais pas noté.