Ga aan de slag met de Notiondesk REST API

Met de REST API Notiondesk kunt u uw helpcentra beheren met uw eigen code. U kunt uw helpcentra weergeven, hun artikelen, collecties en wijzigingslogboek lezen, paginadirecties beheren, instellingen en branding wijzigen, analyses en feedback van lezers ophalen en synchronisaties vanuit Notion activeren.

Dit artikel legt uit wat de Notiondesk API kan doen, wie hem kan gebruiken en hoe u binnen enkele minuten uw eerste verzoek kunt indienen.

Wat je kunt doen met de Notiondesk API

Voor kant-en-klare scripts, zie Veelvoorkomende helpcentrumtaken automatiseren met de Notiondesk API .

Wie kan de Notiondesk API gebruiken?

• Abonnement: API-toegang is inbegrepen in de Enterprise-abonnementen.

• Sleutels aanmaken: Werkruimte-eigenaren en beheerders maken API-sleutels aan in het dashboard.

• Machtigingen: Een sleutel of een app kan nooit meer doen dan de persoon die erachter zit in uw werkruimte. Zie Authentiseren met de Notiondesk API met behulp van API-sleutels .

Doe je eerste Notiondesk API-aanvraag

1. Maak een API-sleutel aan

Open in je Notiondesk dashboard de instellingen , ga vervolgens naar Ontwikkelaars > API-sleutels en klik op Sleutel maken . Geef de sleutel een label, selecteer het leesbereik en kopieer de sleutel wanneer deze wordt weergegeven. De sleutel begint met nd_wsk_ en wordt slechts één keer weergegeven.

Sla het op in een omgevingsvariabele:

2. Geef een lijst van uw helpcentra.

Het antwoord geeft een lijst van alle helpcentra in uw werkruimte:

3. Geef een lijst van de artikelen in een helpcentrum.

Dat is alles! Je leest je helpcentrum nu via code.

Notiondesk API-basisprincipes

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 of Workspace MCP?

Notiondesk biedt twee manieren om uw helpcentra buiten het dashboard te beheren. Ze bieden via verschillende ingangen toegang tot dezelfde functies.

Notiondesk API-eindpunt

Veelgestelde vragen

Wat volgt?

• Authenticeer bij de Notiondesk API met behulp van API-sleutels.

• Verbind je app met Notiondesk via OAuth.

• Verwerk API-fouten, snelheidslimieten en herhaalpogingen voor Notiondesk.

• Automatiseer veelvoorkomende helpcentrumtaken met de Notiondesk API