En tant que Partenaire, vous êtes en mesure d'utiliser nos différentes API pour accéder, publier et modifier des données sur la plateforme Dailymotion.
Dans cet article, vous obtiendrez plus d'informations sur nos différents types de clés API, et vous apprendrez comment gérer une clé API afin de configurer facilement différents niveaux d'accès pour les chaînes au sein de votre organisation.
Gestion des clés API
Seul le propriétaire et les administrateurs peuvent accéder à la gestion des API disponibles dans le menu Organisation
Obtenez plus d'informations sur les rôles disponibles dans votre organisation.
Comprendre les clés API
Dailymotion propose 2 types d'API différents : L'une pour vos applications côté client et l'autre pour vos applications côté serveur :
Clé API publique
| Recommandations | Convient mieux aux applications côté client où les clés doivent être publiques. |
|---|---|
| Accès aux données privées | Pour accéder aux données privées, un token d'accès devra être généré avec un nom d'utilisateur et un mot de passe, en complément de la clé et du secret. |
| Endpoints disponibles |
Le token d'accès généré est compatible avec :
|
Clé API privée *
| Recommandations | Convient mieux aux applications côté serveur où les clés peuvent être cachées. |
|---|---|
| Accès aux données privées | Pour accéder aux données privées, un token d'accès doit être généré avec seulement la clé et le secret. |
| Endpoints disponibles |
Le token d'accès généré est compatible avec :
|
* Les Clés API privées ne sont disponibles que pour les Partenaires certifiés. Merci de contacter votre manager dédié ou notre Équipe Support pour plus de détails.
Comprendre vos tokens API
Les clés API publiques et privées peuvent être utilisées pour générer des tokens API, qui sont nécessaires pour effectuer des appels API.
Selon le type de clé API, différentes méthodes peuvent être utilisées pour générer votre token API.
Clé API publique
| Token généré en utilisant... | Clé API et secret | Clé API et secret + identifiants utilisateur |
|---|---|---|
| Données | Données publiques uniquement | Données publiques et privées |
| Accès à la chaîne | N/A | Accès à la chaîne à partir de l'identifiant fournis par l'utilisateur. |
| Champs et autorisations |
Permissions de lecture par défaut uniquement |
Permissions à partir de l'identifiant fournis par l'utilisateur. |
Clé API privée *
| Token généré en utilisant... | Clé API et secret |
|---|---|
| Données | Données publiques et privées |
| Accès à la chaîne | La chaîne est accessible en fonction des autorisations définies pour cette clé API. |
| Champs et autorisations |
Les champs et les autorisations sont basés sur les autorisations définies pour cette clé API. |
* Les Clés API privées ne sont disponibles que pour les Partenaires certifiés. Merci de contacter votre manager dédié ou notre Équipe Support pour plus de détails.
Créer une nouvelle clé API
Pour créer une nouvelle clé API, veuillez procéder comme suit :
- Allez sur votre Dailymotion Studio et cliquez sur Organisation dans le menu de navigation.
- Cliquez sur Clés API et sélectionnez Créer une clé API.
- Sélectionnez le type de clé API que vous souhaitez créer.
- Remplissez le formulaire avec les informations de votre clé API (titre, callback, description...)
- Cliquez sur "Créer".
Votre clé API et votre secret seront désormais affichés dans votre liste de clés API.
Stockez votre secret API
Notez que pour les clés API privées, le secret n'est affiché qu'une seule fois ! L'équipe support ne sera pas en mesure de le récupérer pour vous. Veillez donc à le copier et à le conserver dans un endroit sûr.
Modifier une clé API
Pour modifier vos clés API, veuillez procéder comme suit :
- Allez sur votre Dailymotion Studio et cliquez sur Organisation dans le menu de navigation.
- Cliquez sur Clés API
- Cliquez sur la clé API que vous souhaitez modifier.
- Effectuez les modifications souhaitées et cliquez sur Enregistrer
Suppression d'une clé API
Pour supprimer une de vos clés API, veuillez procéder comme suit :
- Allez sur votre Dailymotion Studio et cliquez sur Organisation dans le menu de navigation.
- Cliquez sur Clés API
- Cliquez sur le bouton Supprimer à côté de la clé API que vous souhaitez supprimer.
Suppression des clés API sur les applications
Notez que toute application qui utilise encore cette clé API ne fonctionnera plus une fois la clé supprimée.
Utiliser une clé API
La clé API peut être utilisée pour s'authentifier auprès des API de Dailymotion. Veuillez vous référer au Guide d'authentification pour apprendre comment utiliser les clés API pour générer des tokens d'accès.