API - logo

A . P . I .

Trois lettres qu’on croise souvent dans le monde informatique et dont on ne connaît pas forcément le sens. 

Une API  (Application Programming Interface / Interface de Programmation d’Application) permet à deux applications de communiquer entre elles.

L'API en bref

  • Une des principales fonctionnalités d’une API est le partage d’informations entre deux applications.
  • Ces informations sont échangées selon un format de données structurées connu par les deux applications.

Pourquoi une clé pour les API ?

Lorsque vous naviguez sur un site qui demande un compte, vous remplissez un formulaire pour vous authentifier : un champ pour votre identifiant et un champ pour le mot de passe. L‘utilisation d’une API permet à une application d’interroger une autre application sans passer par des pages (donc pas de formulaire).

Mais si l’application ciblé nécessite un compte, vous devriez normalement renseigner vos identifiants à la première application pour qu’elle puisse interroger la deuxième en votre nom. C’est pour vous éviter d’exposer vos identifiants que les sites avec comptes peuvent vous mettre à disposition une “clé”. Cette clé identifie de façon unique votre compte, pour vous éviter de diffuser vos identifiants. C’est alors cette clé que vous fournissez à la première application, et qu’elle utilisera pour obtenir des informations sur votre compte sécurisé.

Cette clé (ou KEY en anglais) est parfois appelée “Token”.

Quel API et pour quoi ?

Plusieurs habillages (skins) et Extensions (Addons) nous demandent d’inscrire nos clés API afin de pouvoir bénéficier d’informations supplémentaires. Regardons ensemble à quoi sert chacune d’elles.

L'API TMDb

L’API TMDB est l’interface mis à disposition par le site themoviedb.org.
Ce site nécessite un compte, donc une clé API est à récupérer sur son compte.
Si vous utilisez vStream, cette extension utilise sa propre clé et vous n’aurez donc pas besoin de créer de compte si vous n’utilisez que les médias de cette extension.

C’est grâce à cette API que Kodi (et certaines de extensions) récupèrent les informations des films et des Séries TV que l’on nomme : les métadonnées.

C’est ainsi que nous pouvons avoir toutes les informations pour chacun de nos médias. Si un film n’est pas référencé sur le site, nous ne pourrons en aucun cas voir les informations sur notre installation Kodi (à moins d’utiliser un service alternatif ou de créer manuellement un fichier NFO à fournir à Kodi).

Les métadonnées récupérées de l’API TMDB sont  :

  • Le synopsys (résumé du film et série)
  • La distribution (acteurs et équipe de production)
  • La notation TMDb
  • Le poster (film et série)
  • Le fanart (film et série)
  • L’imagette d’épisode (épisode télé)
  • Les notations IMDb et Trakt (peuvent aussi être récupérées via l’API si l’option est activée dans les paramètres de notre fournisseur d’info de notre médiathèque locale)

(Pour connaître les différents types d’affichage, consultez cette documentation

L'API OMDb

Cette API permet d’interroger le site “the Open Movie DataBase”.
Ce site nécessite un compte et une clé d’API devra être fournie.

Cette API permet à notre skin (et certains addons) de récupérer des informations supplémentaires que nous ne pouvons pas afficher avec l’API TMDb. On y retrouve:

  • Les métacritiques
  • Les notations Rotten Tomatoes
  • Les notations supplémentaires (IMBb, Trakt) pour les médias d’addons (comme vStream)
  • Les informations supplémentaires (tels que logos de gagnants d’OSCAR)
SANS API OMDB
AVEC API OMDB

API Fanart.tv

L’API Fanart.tv est liée à tout ce qui est ”Affiches supplémentaires”. C’est à dire: les affiches autres que Poster, Fanart et imagettes d’épisodes (thumb). Grâce à cet API, nous pouvons récupérer:

  • ClearArt
  • ClearLogo
  • Affiches Landscape
  • Posters supplémentaire
  • Fanarts supplémentaires
 
Ce site nécessite un compte, donc une clé API est à récupérer sur son compte.
Affichage Landscape sans API Fanart.tv
Affichage landscape avec API Fanart.tv

2 réactions sur “Les clés API

  1. Bonsoir, merci pour le travail.
    Je souhaiterais savoir où se renseigne la clé API OMDb dans KODI.
    Merci d’avance.

    Hugging Face
    1
  2. Bonjour!
    La clé OMDb se renseigne depuis les paramètres d’un addon tel que TMDb helper ou Embuari info. Ce n’est pas directement à l’intérieur de kodi, plutôt via un addon qui fourni des informations médias. ?

Laisser un commentaire