Ceci est une ancienne révision du document !
Bddxmltvids est une api web permettant
Cette base est communautaire faite le savoir au utilisateur de votre applications ! Les logos et nom de chaîne son des marquées déposées.
Les données peuvent être utilisée gratuitement pour toutes utilisation non-commerciale. Pour une utilisation commerciale contacter nous.
En contribuant à cette base vous acceptez implicitement que les données soit diffusées de façon gratuite ou payante (les éventuelles bénéfices serviront à payer les frais relatif à l'hebergement ou seront verser à notre convenance a différent projets autours de la philosophie du libre).
Le service n'est pas garanti Nous nous reservons le doit de interrompre sans pré-avis.
L'accès à l'API se fait par protocole HTTP les arguments peuvent être transmit par POST ou GET.
Exemple :
Information sur les arguments et réponses pour l'ensemble des fonction d'accès au donnée.
Arguments
format
) : format de la réponse. Une valeur : json, php, txt, html. Json par défaut.countrys
) : Pays au format ISO_3166-2 dans les quels faire la recherches. Séparateur “,”. Tous par défaut.Réponse
data
: les données trouvée (vide si aucune donnée)infos
) : informations diverses sous forme d'une listes. Absent si aucune information.warnings
) : avertissements sous forme d'une listes. Absent si aucune avertissement.errors
) : erreurs sous forme d'une listes. Absent si aucune erreur.Récupère les données d'une chaînes par son id ou son alias.
Arguments
id
) : identifiant unique de la chaîne. Requis si alias
n'est pas indiqué.alias
) : alias (variante orthographique) ou nom de la chaîne. Requis si id
n'est pas indiqué. Ignoré si id
est indiqué.Réponse
data
channels
id
: identifiant unique de la chaînename
: nom de la chaînecountry
: pays de diffusionlogo
: url vers le logo de la chaineChercher une chaîne.
Arguments
Réponse
data
channels
: identique à get_channels retourne au maximum 20 résultats.Information sur les arguments et réponses pour l'ensemble des fonction d'envoi de données.
Arguments
format
) : format de la réponse. Une valeur : json, php, txt, html. Json par défaut.email
) : Email de notification. Seule les modérateurs y aurront accès. Optionnel.Réponse
data
: les données trouvée (vide si aucune donnée)infos
) : informations diverses sous forme d'une listes. Absent si aucune information.warnings
) : avertissements sous forme d'une listes. Absent si aucune avertissement.errors
) : erreurs sous forme d'une listes. Absent si aucune erreur.Ajoute ou met à jours une ou plusieurs chaînes.
Arguments
channels
: liste des chaines au format json [<chaîne1>, <chaîne2>, …]
chaque chaîne devra contenir au minimum un id. On on pourra indiquer un nom, le pays de diffusion, un logo et/ou des alias de nom (variante orthographique).
id
sous la forme usuelle <nom_de_la_chaine>.<pays> insensible à la case. Seul les caractéres alphanumérique les “_” et les “-” sont acceptés. Les espaces et caractères spéciaux ne peuvent être utilisés.name
) : nom de la chainecountry
) pays de diffusion au format ISO_3166-2logo
) : une source libre si possible (wikipedia))alias
) : insensible à la case, mettre le nom de la chaîne est inutile.Réponse
data
channels
: Liste des chaînes sous la même forme que get_channel qui on eu au moins une modification.alias
: liste des alias [<alias1>, < alias2>, …]
acceptés. Chaque alias contient id
de la chaîne et l' alias
.Ajoute ou met à jours un ou plusieurs grabbers.
Arguments
grabbers
: liste des chaines au format json [<grabber1>, <grabber2>, …]
chaque grabber devra contenir au minimum un id. On pourra indiquer un nom, le pays de diffusion, et/ou l'url vers le site du grabber.{ "id": "kazer.org", "name": "KaZeR", "country": "fr", "web": "http://www.kazer.org", }
id
sous la forme usuelle <nom_du_grabber>.<pays> insensible à la case. Seul les caractéres alphanumérique les “_” et les “-” sont acceptés. Les espaces et caractères spéciaux ne peuvent être utilisés.name
) : nom de la chainecountry
) pays de diffusion au format ISO_3166-2web
) : url vers le site web (sous la forme http://...)Réponse
data
grabbers
: liste des grabbers acceptées par l'api sous la même forme qu'en entrée.Ajoute ou met à jours un ou plusieurs xmltvids.
Arguments
xmltvids
: liste des entrées xmltvids au format json [<xmltvid1>, < xmltvid2>, …]
chaque entrée devra contenir grabber_id
, channel_id
et xmltvid
{ "grabber_id": "kazer.org", "channel_id": "france2.fr", "xmltvid": "fra2.kazer.org", }
grabber_id
: id du grabber qui doit exister (mais pas obligatoirement avoir été accepté)channel_id
: id de la chaîne qui doit exister (mais pas obligatoirement avoir été accepté)xmltvid
: xmltvidRéponse
data
xmltvids
: liste des grabbers acceptées par l'api sous la même forme qu'en entrée.