Commencez à utiliser l'API REST Notiondesk

L'API REST Notiondesk permet à votre propre code de gérer vos centres d'aide. Vous pouvez ainsi lister vos centres d'aide, consulter leurs articles, collections et historique des modifications, gérer les redirections de pages, modifier les paramètres et l'image de marque, récupérer les données analytiques et les commentaires des lecteurs, et déclencher des synchronisations depuis Notion.

Cet article explique ce que l'API Notiondesk peut faire, qui peut l'utiliser et comment effectuer votre première requête en quelques minutes.

Que pouvez-vous faire avec l'API Notiondesk ?

Pour des scripts prêts à l'emploi, consultez Automatiser les tâches courantes du centre d'aide avec l'API Notiondesk .

Qui peut utiliser l'API Notiondesk

• Formule : L’accès à l’API est inclus dans les formules Entreprise.

• Création de clés : Les propriétaires et administrateurs d’espace de travail créent des clés API dans le tableau de bord.

• Autorisations : Une clé ou une application ne peut jamais faire plus que la personne qui la détient dans votre espace de travail. Consultez la section « S’authentifier auprès de l’API Notiondesk à l’aide de clés API » .

Effectuez votre première requête API Notiondesk

1. Créez une clé API

Dans votre tableau de bord Notiondesk, ouvrez Paramètres , puis Développeurs > Clés API et cliquez sur Créer une clé . Attribuez-lui un nom, sélectionnez l'étendue de lecture et copiez la clé lorsqu'elle s'affiche. La clé commence par nd_wsk_ et n'est affichée qu'une seule fois.

Stockez-le dans une variable d'environnement :

2. Dressez la liste de vos centres d'aide

La réponse liste tous les centres d'aide de votre espace de travail :

3. Énumérer les articles d'un centre d'aide

Et voilà ! Vous consultez votre centre d'aide directement depuis le code.

Notiondesk Principes de base de l'API

export NOTIONDESK_API_KEY="nd_wsk_..."

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

{
  "object": "list",
  "data": [
    {
      "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
      "full_domain": "help.example.com",
      "enabled": true,
      "default_locale": "en",
      "locales": ["en", "fr"]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "<https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/articles?page_size=10>" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

Notiondesk API ou Workspace MCP ?

Notiondesk propose deux façons d'accéder à vos centres d'aide en dehors du tableau de bord. Ils permettent d'accéder aux mêmes fonctionnalités par des voies différentes.

Notiondesk Point de terminaison de l'API

Questions fréquentes

Et ensuite ?

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

• Connectez votre application à Notiondesk avec OAuth

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

• Automatisez les tâches courantes du centre d'assistance grâce à l'API Notiondesk