Fork me on GitHub
Phraseanet Documentation

Créer des applications en utilisant l’API Phraseanet

Phraseanet dispose d’une API publique, permettant aux développeurs d’intégrer les documents (vidéos, photos etc ...) et fonctionnalités Phraseanet sur des applications tierces.

  • site internet
  • application mobile
  • application de bureau

Pour commencer :

Enregistrer une application auprés de l’API phraseanet

Cliquer sur le login dans le menu Phraseanet.

Dans la rubrique Phraseanet mon compte

Cliquer sur l’onglet Développeur

../_images/MonCompteDeveloppeur.png

Cliquer sur créer une nouvelle application

../_images/MonCompteDeveloppeurCreate.png
  • Donner un nom à l’application
  • Remplir la description concernant l’application, cette information est à destination de l’utilisateur qui utilisera votre application, elle sera affiché sur la page d’authentification, veiller à être précis en expliquant brièvement le but de votre application.
  • Remplir le champ du site internet de votre application, ce champ est obligatoire. Ce lien est présenté à l’utilisateur sur la page d’authentification à votre application
  • Choisir le type d’application développée application internet ou application de bureau
  • S’il s’agit d’une application internet, remplir le champ d’url de rappel Les utilisateurs authentifiés seront automatiquement redirigés sur cet URL aprés leur authentification

Une fois l’application enregistrée elle apparaît dans un tableau de bord

../_images/MonCompteDeveloppeurDashboard.png

Le tableau de bord liste toutes les applications créées par l’utilisateur authentifié.

Paramètres d’une application

Dans le tableau de bord des applications développeurs cliquer sur le nom d’une application ; la page des paramètres de l’application s’affiche.

../_images/MonCompteDeveloppeurApplication.png

Cette page présente

  • Le Client ID est un identifiant unique public de l’application
  • Le Client Secret est un mot de passe privé de l’application afin d’identifier le propriétaire de l’application, ne jamais divulguer cette information.
  • L’url de rappel de l’application, celle-ci peut être édité à tout moment en passant la souris dessus.
  • Les points d’authentifiaction concernant l’autorisation et l’accès à l’API
  • L’activation du grant_type password qui permet à votre application d’identifier les utilisateurs grâce à leurs identifiants Phraseanet

Avertissement

N’utiliser le grant_type password que si et seulement si le propriétaire de la ressource à une grande relation de confiance avec l’application cliente.

  • Le jeton d’accés développeur est le token qui identifie le propriétaire de l’application sur l’API phraseanet.

Note

Le jeton développeur peut être utilisé lors du développement de l’application ou bien pour effectuer des requêtes sur l’API par l’intermediaire d’un processus automatisé qui ne nécessite pas d’authentification.

Voir aussi

Phraseanet s’appuie sur le protocole d’authentification oAuth2.0. Pour une meilleure connaissance des processus de création et d’authentification des applications clientes à l’API Phraseanet, consulter la RFC du protocole Oauth2.