Une API française pour les métadonnées du livre.

Paramètres : parent_id (optionnel). Sans parent_id → catégories racines. Auth : X-API-Key. Réponse JSON.

curl -i "https://metasbooks.fr/api/v1/categories" -H "X-API-Key: VOTRE_CLE"

curl -i "https://metasbooks.fr/api/v1/categories?parent_id=1" -H "X-API-Key: VOTRE_CLE"

Auth : X-API-Key. Réponse JSON (crédits, plan, statut, etc.).

curl -i "https://metasbooks.fr/api/v1/account" -H "X-API-Key: VOTRE_CLE"

curl -i "https://metasbooks.fr/health"

Paramètres : ean (13 chiffres). Auth : X-API-Key. Réponse JSON.

curl -i "https://metasbooks.fr/api/v1/is_ean_available?ean=9782070360024" -H "X-API-Key: VOTRE_CLE"

Auth : X-API-Key. Méthode : POST. Body : JSON. Réponse JSON.

✅ Coût : 0 crédit.
🎁 Récompense : +50 crédits si l’EAN n’existe pas encore et que la fiche est créée.
ℹ️ Si l’EAN existe déjà : created:false, credited:0.

Champs obligatoires :
ean, titre, auteur, editeur, description, image_url

Champs optionnels :
serie, num_serie

⚠️ La soumission est refusée si un champ obligatoire est manquant ou si l’URL d’image n’est pas valide.

curl -i "https://metasbooks.fr/api/v1/books/submit" \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  --data '{
    "ean":"9782070360024",
    "titre":"Titre du livre",
    "auteur":"Auteur",
    "editeur":"Éditeur",
    "description":"Description complète du livre…",
    "image_url":"https://exemple.com/couverture.jpg",
    "serie":"Nom de la série",
    "num_serie":"2"
  }'

Codes possibles : 201 (créée), 200 (déjà existante), 400 (champs manquants / image invalide), 403 (compte inactif).

Auth : X-API-Key. Body : JSON (recommandé) ou x-www-form-urlencoded. Réponse JSON. Le livre doit exister en base.

✅ Coût : 0 crédit.
🎁 Récompense : si la correction est jugée valable et acceptée, votre compte est crédité de +20 crédits.

Champs acceptés (optionnels) : titre, auteur, editeur, collection, serie, num_serie, format, presentation, date_parrution, nbpages, poids, largeur, hauteur, epaisseur, category_id, image_key, description.
⚠️ Il faut au moins 1 champ utile (sinon missing_fields).

curl -i "https://metasbooks.fr/api/v1/suggest/edit" \
  -H "X-API-Key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  --data '{
    "ean":"9782070360024",
    "titre":"NOUVEAU TITRE",
    "description":"Description corrigée…"
  }'

Astuce : si tu veux “vider” un champ, envoie la clé avec une valeur vide (ex: "collection": "") — le serveur enregistrera null.

Réponse JSON : total et derniers ajouts/updates (utilisé par le bloc “En temps réel”).

curl -i "https://metasbooks.fr/api/v1/stats/books"

Paramètre : ean. Affiche une page HTML basée sur les données du livre cible.

curl -i "https://metasbooks.fr/book?ean=9782070360024"