diff --git a/scripts/docs/fr/140.account-settings/fr-020.api-tokens.md b/scripts/docs/fr/140.account-settings/fr-020.api-tokens.md index e69de29bb2..e8d5c31a02 100644 --- a/scripts/docs/fr/140.account-settings/fr-020.api-tokens.md +++ b/scripts/docs/fr/140.account-settings/fr-020.api-tokens.md @@ -0,0 +1,86 @@ +*** + +titre : 'Jetons API' +description: 'Cet article explique comment créer et utiliser des jetons API.' +balises : \['Paramètres du compte', 'Jetons API'] +mots-clés : \['jetons API', 'créer un jeton API', 'supprimer un jeton API'] +--------------------------------------------------------------------------- + +## Créer un jeton API + +Ouvrez la page Paramètres du compte à partir du menu utilisateur dans le coin inférieur gauche de la barre latérale. + +1. Cliquer sur`User menu`dans le coin inférieur gauche de la barre latérale, +2. Sélectionner`Account Settings`depuis la liste déroulante + +![profile page](/img/v2/account-settings/account-settings.png) + +Suivez les étapes ci-dessous pour créer un jeton API + +1. Cliquer sur`Tokens`onglet dans le`Account Settings`page +2. Cliquer sur`Add New API Token` +3. Entrez le nom du jeton API +4. Cliquer sur`Save`bouton pour enregistrer les modifications +5. Copiez le Token API en cliquant sur`Copy`bouton affiché sous`Actions`menu +6. Utilisez le jeton API dans les services qui nécessitent son authentification en tant que`xc-token`dans les en-têtes. + +```json +{ + "headers": { + "xc-token": "Copied API token here under quotes" + } +} +``` + +![Create API Token](/img/v2/account-settings/api-token-1.png) + +![Create API Token](/img/v2/account-settings/api-token-2.png) + +:::avertissement + +* Un seul token peut être créé par utilisateur +* Le jeton API n'expire pas, mais il peut être supprimé à tout moment. + ::: + +Le jeton API créé sera ajouté à la liste. Copiez le jeton API en cliquant sur`Copy`bouton affiché sous`Actions`menu + +![Create API Token](/img/v2/account-settings/api-token-3.png) + +## Supprimer le jeton API + +Ouvrez la page Paramètres du compte à partir du menu utilisateur dans le coin inférieur gauche de la barre latérale. + +1. Click on `User menu`dans le coin inférieur gauche de la barre latérale, +2. Sélectionner`Account Settings`depuis la liste déroulante + +![profile page](/img/v2/account-settings/account-settings.png) + +1. Click on `Tokens`onglet dans le`Account Settings`page +2. Du`Actions`menu, cliquez sur`Delete`bouton associé au Token API à supprimer + +![Delete API Token](/img/v2/account-settings/api-token-4.png) + +:::avertissement +Notez que tous les services utilisant le jeton API cesseront de fonctionner une fois le jeton API supprimé. +::: + +## Jetons d'authentification + +Pour des expériences rapides avec l'API, vous pouvez utiliser le`Auth Tokens`pour générer un jeton temporaire. Ces jetons sont valables pour une session jusqu'à la déconnexion de l'utilisateur ou pendant 10 heures. + +Suivez les étapes ci-dessous pour copier le jeton AUTH + +1. Cliquer sur`User menu`dans le coin inférieur gauche de la barre latérale, +2. Sélectionner`Copy Auth Token`depuis la liste déroulante + +```json +{ + "headers": { + "xc-auth": "Copied auth token here under quotes" + } +} +``` + +:::note +Pour l'auto-hébergé, vous pouvez reconfigurer le délai d'expiration à l'aide de la variable d'environnement`NC_JWT_EXPIRES_IN`. La valeur par défaut est 10 heures. +:::