Documentation API
Glivres expose une API publique en lecture seule pour rechercher les livres et offres disponibles, consulter les catégories et découvrir ses ressources publiques.
Accès
- URL de base :
https://www.glivres.fr - Format : JSON UTF-8
- Authentification : aucune pour les routes documentées sur cette page
- Usage : lecture seule, avec une limite globale d'infrastructure de 200 requêtes par minute
Le contrat machine complet est disponible dans openapi.json.
Recherche de livres
GET /api/search
Paramètres disponibles : q, page, per_page, condition, category, language, vendor, author, publisher, price_min, price_max, tag, year_min, year_max et sort.
Valeurs de tri : price_asc, price_desc, newest ou title.
curl "https://www.glivres.fr/api/search?q=Victor%20Hugo&per_page=5"Autres routes publiques
| Route | Fonction |
|---|---|
GET /api/book/{id} | Détail d'un livre et offres actives. |
GET /api/categories | Liste des catégories publiques. |
GET /api/public-resources | Catalogue des pages et ressources publiques. |
GET /api/taxonomy-maintainers | Données publiques indiquant les taxonomies maintenues et corrigées par Glivres. |
Serveur MCP
Le point d'entrée MCP public utilise le transport Streamable HTTP sur POST https://www.glivres.fr/mcp.
Il expose les ressources publiques sous les URI glivres://public-resources/{slug} et le tool read-only get_taxonomy_maintainers. Un client MCP découvre ces capacités avec resources/list et tools/list.