Wiki

Outils pour utilisateurs

Outils du site


bddxmltvids

Ceci est une ancienne révision du document !


Bddxmltvids

Cette page concerne doc-fr.

En cours de développements actuellement pas disponible publiquement

Roadmap

Bddxmltvids est une api web permettant

  1. de trouver d'après un nom de chaîne ou de l'une de ces variante orthographiques l'xmltvid de votre grabber, le logos, et le nom officiel TODO le multliplex en fonction de la région
  2. la liste des chaines pour un bouquet

Conditions d'utilisations

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.

Documentation

L'accès à l'API se fait par protocole HTTP les arguments peuvent être transmit par POST ou GET.

Exemple :



Accès au données

Communs

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.

get_channels

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îne
      • name : nom de la chaîne
      • country : pays de diffusion
      • logo : url vers le logo de la chaine

search_channel

Chercher une chaîne.

Arguments

  • q : texte à chercher

Réponse

  • data
    • channels : identique à get_channels retourne au maximum 20 résultats.

Envoie de données

Communs

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.

set_channels

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 chaine
    • (country) pays de diffusion au format ISO_3166-2
    • (logo) : 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.

set_grabbers

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 chaine
    • (country) pays de diffusion au format ISO_3166-2
    • (web) : 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.

set_xmltvids

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 : xmltvid

Réponse

  • data
    • xmltvids: liste des grabbers acceptées par l'api sous la même forme qu'en entrée.
bddxmltvids.1396818878.txt.gz · Dernière modification: 06/04/2014 par snouf