Authentifiez-vous auprès de l'API Notiondesk à l'aide de clés API.

Chaque requête API Notiondesk est authentifiée par un jeton d'authentification : une clé API d'espace de travail ou un jeton d'accès OAuth pour les applications agissant pour le compte d'autres clients Notiondesk. Cet article explique comment créer une clé API Notiondesk, choisir ses autorisations, l'envoyer avec vos requêtes et la renouveler ou la révoquer.

Utilisez une clé API pour les automatisations exécutées dans votre propre espace de travail : script, tâche planifiée, étape d’intégration continue ou outil interne. Si vous développez une application à laquelle d’autres clients Notiondesk se connectent, utilisez plutôt OAuth .

Avant de commencer

• Votre espace de travail est sur un forfait Entreprise.

• Vous êtes le propriétaire de l'espace de travail ou un administrateur.

Créez une clé API Notiondesk

1. Dans votre tableau de bord Notiondesk, cliquez sur Paramètres .

2. Sous Espace de travail , ouvrez Développeurs , puis Clés API .

3. Cliquez sur Créer une clé .

4. Saisissez une étiquette indiquant à quoi sert la clé, par exemple CI automation ou Redirect import.

5. Sous « Étendues » , sélectionnez uniquement les étendues nécessaires à l’intégration. Voir « Choisir les étendues appropriées » .

6. Choisissez une date d'expiration : 30 jours , 90 jours , 1 an ou aucune date d'expiration .

7. Cliquez sur Créer .

8. Cliquez sur « Copier la clé » et enregistrez-la dans votre gestionnaire de secrets ou vos variables d'environnement.

9. Cliquez sur « J'ai enregistré la clé » .

La clé n'apparaît qu'une seule fois. Si vous la perdez, faites-la pivoter pour obtenir un nouveau secret.

Remarque : Si l’option « Créer une clé » affiche un cadenas et l’infobulle « Disponible avec les abonnements incluant l’accès à l’API », votre abonnement ne comprend pas l’API. Cliquer dessus ouvre les options de mise à niveau.

Choisissez les bonnes lunettes de visée

Un scope est une autorisation associée à une clé. Chaque route API Notiondesk requiert un scope, et une clé peut en contenir plusieurs.

Attribuez à chaque intégration le plus petit ensemble de portées dont elle a besoin :

Comment les rôles dans l'espace de travail limitent une clé

Une clé ne peut jamais faire plus que la personne qui l'a créée dans votre espace de travail.

Si le rôle du créateur change, les portées effectives de la clé changent également. Si le créateur quitte l'espace de travail, la clé cesse de fonctionner. Gérez les rôles dans la section « Comment inviter un membre d'équipe » .

Envoyez la clé avec chaque requête

Envoyez la clé dans l'en-tête Authorization avec le schéma Bearer :

Un fichier 200 OK contenant la liste de vos centres d'aide confirme que la clé fonctionne. Une seule clé est valable pour tous les centres d'aide de son espace de travail.

La même requête en JavaScript :

Et en Python :

Conservez votre clé API Notiondesk en lieu sûr.

curl "<https://api.notiondesk.so/sites>" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

const response = await fetch("<https://api.notiondesk.so/sites>", {
  headers: {
    Authorization: `Bearer ${process.env.NOTIONDESK_API_KEY}`,
    "nd-version": "2026-10-16",
  },
});

const sites = await response.json();

import os
import requests

response = requests.get(
    "<https://api.notiondesk.so/sites>",
    headers={
        "Authorization": f"Bearer {os.environ['NOTIONDESK_API_KEY']}",
        "nd-version": "2026-10-16",
    },
)
sites = response.json()

• Conservez vos clés sur votre serveur. Ne les intégrez jamais dans le code du navigateur, une application mobile ou un dépôt public.

• Stockez les clés dans des variables d'environnement ou un gestionnaire de secrets, et non dans le code source.

• Créez une clé par intégration, avec sa propre étiquette, afin de pouvoir en révoquer une sans affecter les autres.

• Choisissez une durée de validité pour les clés utilisées par les scripts temporaires.

• Changez de clé lorsqu'une personne qui la connaissait quitte votre équipe.

• Vérifiez la colonne « Dernière utilisation » et révoquez les clés inutilisées.

Tourner ou révoquer une clé

Ouvrez Paramètres > Développeurs > Clés API et utilisez le menu situé à la fin de la ligne de la clé.

La rotation remplace le secret. Confirmez avec Rotation : le secret actuel cesse immédiatement de fonctionner et le nouveau secret est affiché une seule fois. Mettez à jour votre intégration sans tarder. Une clé expirée ne peut pas être renouvelée ; créez-en une nouvelle.

La révocation désactive définitivement la clé. Confirmez avec Révoquer : les automatisations utilisant la clé cessent immédiatement de fonctionner, et cette action est irréversible.

Dépannage de l'authentification

WWW-Authenticate: Bearer error="insufficient_scope", scope="sync"

Questions fréquentes

Et ensuite ?

• Commencez à utiliser l'API REST Notiondesk

• Connectez votre application à Notiondesk avec OAuth

• Gérer les erreurs, les limites de débit et les nouvelles tentatives de l'API Notiondesk