Introduction

Jeu de caractères

L'API DVDFr utilise des flux XML encodés en UTF-8. Toutes les requêtes doivent-être encodées dans ce même jeu de caractères.

Requêtes HTTP / User Agent

Les appels à l'API doivent-être fait avec un USER_AGENT propre à votre logiciel. DVDFr se réserve la possibilité de filtrer les USER_AGENT génériques (vides ou correspondant à un navigateur ou une API HTTP générique).

Erreurs

Les erreurs sont renvoyées sous forme de flux XML. La structure de ces messages d'erreur est toujours la suivante :

<errors>
	<error type="[fatal|warning]">
		<code>CODE_ERREUR</code>
		<message>Message d'erreur</message>
	</error>
</errors>
		

Recherche


Fiche

Présentation

Cette API vous permet de récupérer les spécifications techniques d'un DVD (ou UMD / Blu-ray, etc.).

L'utilisation de cette API est limitée par un système de quotas (cf. utilisation des quotas). Le quota actuel est de 200 fiches par semaines. Il est possible de réinitialiser ce quota 5 fois. Tout appel à l'API fiche compte pour une utilisation de ce quota. Nous vous déconseillons donc d'appeler l'API fiche pour chaque résultat de recherche.

Adresse

http://www.dvdfr.com/api/dvd.php

Paramètres

Paramètre Type Description
id Obligatoire Identifiant DVDFr de la fiche à récupérer.
bandeAnnonce Facultatif Si ce paramètre est positionné renvoit les informations sur les bandes-annonces (URL, identifiant, etc.). Ne fonctionne que pour les appels signés à l'API.
json Facultatif / expérimental Si ce paramètre est positionné, le résultat de l'appel à l'API sera renvoyé sous la forme d'un objet JSON au lieu d'un flux XML
ts Facultatif Utilisé pour les appels signés à l'API. Nous contacter pour plus d'information à ce sujet.
key Facultatif Utilisé pour les appels signés à l'API. Nous contacter pour plus d'information à ce sujet.

Résultats obtenus

Vous obtenez un flux XML avec l'ensemble des caractéristiques techniques de la fiche. Ce flux n'est pas (encore) documenté ici-même mais devrait se suffire à lui-même. Sinon n'hésitez pas à contacter le responsable technique du site pour plus de renseignements.


Quotas

Présentation

Cette API permet de connaitre l'utilisation qui est faite de son quota d'appels à l'API fiche.

Adresse

http://www.dvdfr.com/api/quota.php?xml

Paramètres

Aucun si ce n'est le paramètre xml permettant de récupérer l'information sous forme d'API.

Résultats obtenus

Vous obtenez sous forme XML les informations d'utilisation de votre quota. Vous ne pouvez pas utiliser l'API pour demander la remise à zéro de votre quota, il faut passer par le formulaire sur le site. L'adresse du formulaire est présente dans le flux de résultat :

<quotas generator="$Revision: 1360 $">
    <fetchs>
        <used>2</used>
        <maximum>200</maximum>
    </fetchs>
    <resets>
        <used>0</used>
        <maximum>3</maximum>
        <url>http://www.dvdfr.com/api/quota.php</url>
    </resets>
</quotas>
		

Ce flux est composé de deux informations : la première est liée au nombre d'appels effectués à l'API fiche (<fetchs>) et aux remises à zéro possible (<resets>). Chaque information est décomposée en nombre d'appels effectués (<used>) et en nombre d'appels maximum effectuables (<maximum>). L'URL permettant d'accéder au formulaire de réinitialisation des quotas est aussi donnée dans le flux.

Accès Rapide

(publicité)

(publicité)

En poursuivant votre navigation sur le site, vous acceptez l'utilisation des cookies pour vous proposer notamment des publicités ciblées en fonction de vos centres d'intérêt, l'affichage de vidéos ou encore le partage sur les réseaux sociaux.

OK En savoir plus