API

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 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)

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.

SANS API:

AVEC API: