Documentation de l'API de Collecte de Métadonnées du Livre

Aperçu

L'API de collecte de métadonnées du livre permet aux développeurs d'obtenir des informations détaillées sur un livre en utilisant son numéro ISBN (International Standard Book Number) au format EAN-13. Pour accéder à l'API, vous aurez besoin d'une clé d'API valide, qui doit être incluse dans chaque requête pour autoriser l'accès.

URL de l'API

L'URL de base pour accéder à l'API est :

https://metasbooks.fr/api/lookup_metas.php

Authentification

L'authentification à l'API est réalisée en utilisant une clé d'API qui doit être incluse dans l'url chaque requête. Voici comment ajouter la clé d'API dans l'url :

apikey=VotreCléAPI

Remplacez "VotreCléAPI" par la clé d'API fournie par MetasBooks lors de l'inscription à l'API.

Paramètres de la requête

L'API de collecte de métadonnées de livre prend en charge les paramètres suivants :

• ISBN (obligatoire): Le numéro ISBN au format EAN-13 du livre pour lequel vous souhaitez récupérer les métadonnées. L'ISBN est une chaîne alphanumérique unique qui identifie de manière unique un livre dans son format EAN-13 elle commence généralement par 978 ou 979 suivi de 9 digits d'identification de l'ouvrage et d'un digit qui correspond a une clé de contrôle. Ex: 978-123456789-0


• Le format de réponse souhaité (obligatoire):
  l'API propose deux format de réponse:
  Le format JSON (JavaScript Object Notation): vous devrez pour ce format indiquer dans l'url de votre requête:

  format=json

  
  Le format XML (Extensible Markup Language): vous devrez pour ce format indiquer dans l'url de votre requête:

  format=xml

Exemple d'utilisation

Voici un exemple complet de requête pour récupérer les métadonnées d'un livre en utilisant l'ISBN :

GET https://metasbooks.fr/api/lookup_metas.php?isbn=9782253934103&apikey=VotreCléAPI&format=json

Remplacez "9782253934103" par le numéro ISBN du livre que vous souhaitez interroger, et assurez-vous d'inclure votre clé d'API dans l'url de la requête.

Réponse de l'API

Si votre format de réponse souhaité est le JSON, l'API répondra avec un objet JSON contenant les métadonnées du livre correspondant à l'ISBN fourni. Voici un exemple de réponse JSON:

                {
                ean: "9782253934103",
                titre: "Tout le bleu du ciel",
                auteur: "Mélissa Da Costa",
                editeur: "LGF/Livre de Poche",
                collection: "Le Livre de Poche",
                format: "Poche",
                presentation: "Broché",
                date: "12 Février 2020",
                nbpages: "840",
                poids: "0",
                largeur: "11,0",
                hauteur: "17,8",
                epaisseur: "3,3",
                image_url: "https://metasbooks.fr/api/images/8b79924ea0336b012eb5b0d3b2522747-9782253934103.jpg",
                resume_final: "Petitesannonces.fr : Jeune homme de 26 ans,
                    condamné à une espérance de vie de deux ans par un Alzheimer précoce, souhaite prendre le large pour un ultime
                    voyage. Recherche compagnon(ne) pour partager avec moi ce dernier périple.\r\nÉmile a décidé de fuir l’hôpital, la
                    compassion de sa famille et de ses amis. À son propre étonnement, il reçoit une réponse à cette annonce. Trois jours
                    plus tard, devant le camping-car acheté secrètement, il retrouve Joanne, une jeune femme coiffée d’un grand chapeau
                    noir qui a pour seul bagage un sac à dos, et qui ne donne aucune explication sur sa présence.\r\nAinsi commence un
                    voyage stupéfiant de beauté. À chaque détour de ce périple naissent, à travers la rencontre avec les autres et la
                    découverte de soi, la joie, la peur, l’amitié, l’amour qui peu à peu percent la carapace de douleurs
                    d’Émile.\r\n\r\n<em>Un livre aux dialogues impeccables et aux personnages touchants
                    d’humanité. </em>\r\nPsychologies magazine.\r\n\r\n<em>Bouleversant.
                    </em>\r\nVersion femina.",
                note: null,
                num_serie: null,
                serie: null,
                classification: "Littérature générale > Romans > Romans
                    francophones",
                code_classification: "3435 > 3442 > 3443",
                prix: "10,90",
                reponse: "Trouvé",
                code_reponse: 1
                }
            

Si votre format de réponse souhaité est le XML, l'API renverra une réponse formatée en XML contenant les métadonnées du livre correspondant à l'ISBN fourni. Voici un exemple de réponse XML:

                    <nodes>
<ean>
9782253934103
</ean>
<titre>
Tout le bleu du ciel
</titre>
<auteur>
Mélissa Da
                        Costa
</auteur>
<editeur>
LGF/Livre de Poche
</editeur>
<collection>
Le Livre de Poche
</collection>
<format>
Poche
</format>
<presentation>
Broché
</presentation>
<date>
12 Février
                        2020
</date>
<nbpages>
840
</nbpages>
<poids>
0
</poids>
<largeur>
11,0
</largeur>
<hauteur>
17,8
</hauteur>
<epaisseur>
3,3
</epaisseur>
<image_url>
https://metasbooks.fr/api/images/8b79924ea0336b012eb5b0d3b2522747-9782253934103.jpg
</image_url>
<resume_final>
Petitesannonces.fr : Jeune homme de 26 ans, condamné à une espérance de vie de deux ans par un
                        Alzheimer précoce, souhaite prendre le large pour un ultime voyage. Recherche compagnon(ne) pour partager avec moi
                        ce dernier périple.
                        Émile a décidé de fuir l’hôpital, la compassion de sa famille et de ses amis. À son propre étonnement, il reçoit une
                        réponse à cette annonce. Trois jours plus tard, devant le camping-car acheté secrètement, il retrouve Joanne, une
                        jeune femme coiffée d’un grand chapeau noir qui a pour seul bagage un sac à dos, et qui ne donne aucune explication
                        sur sa présence.
                        Ainsi commence un voyage stupéfiant de beauté. À chaque détour de ce périple naissent, à travers la rencontre avec
                        les autres et la découverte de soi, la joie, la peur, l’amitié, l’amour qui peu à peu percent la carapace de
                        douleurs d’Émile.
                    
                        &lt;em&gt;Un livre aux dialogues impeccables et aux personnages touchants d’humanité. &lt;/em&gt;
                        Psychologies magazine.
                    
                        &lt;em&gt;Bouleversant. &lt;/em&gt;
                        Version femina.
</resume_final>
<note>
</note>
<num_serie>
</num_serie>
<serie>
</serie>
<classification>
Littérature générale > Romans > Romans
                        francophones
</classification>
<code_classification>
3435 > 3442 > 3443
</code_classification>
<prix>
10,90
</prix>
<reponse>
Trouvé
</reponse>
<code_reponse>
1
</code_reponse>
</nodes>
            

Codes d'erreur

L'API peut renvoyer les codes d'erreur HTTP standard en cas de problème, tels que 400 Bad Request, 401 Unauthorized, 404 Not Found, etc. Assurez-vous de traiter ces codes d'erreur correctement dans votre application.

Codes réponse

Outre ces différents code d'erreur, l'API émet un code réponse pour vous permettre d'identifier simplement les requêtes qui n'ont pas abouties.

En cas de succès:

                
JSON:
                reponse: "Trouvé",
                code_reponse: 1
                

                

                
XML:
                <reponse>
Trouvé
</reponse>
<code_reponse>
1
</code_reponse>
                

                
JSON:
                reponse: "Non trouvé",
                code_reponse: 0
                

                

                
XML:
                <reponse>
Non trouvé
</reponse>
<code_reponse>
0
</code_reponse>
                

Un code d'erreur peut également s'afficher si le compte associé a la clé d'API fournie n'a pas suffisement de crédits:

            
JSON:
            reponse: "Crédits insufisants",
            code_reponse: 2
            

            

            
XML:
            <reponse>
Crédits insufisants
</reponse>
<code_reponse>
2
</code_reponse>
            

Verrification de l'état du compte

L'API propose également un end-point permettant de vérifier l'état de votre compte:

GET https://metasbooks.fr/api/check_account.php?apikey=VotreCléAPI

Ce endpoint renvoie un résultat JSON avec le status de votre compte et le nombre de crédits disponibles

            
JSON:
            crédits: 250,
            is_active: 1
            

Le compte est actif si is_active vaut 1 et inactif s'il vaut 0