Notiondesk REST API を使い始めましょう

Notiondesk REST API を使用すると、独自のコードでヘルプセンターを操作できます。ヘルプセンターの一覧表示、記事、コレクション、変更履歴の閲覧、ページリダイレクトの管理、設定やブランディングの変更、分析データや読者からのフィードバックの取得、Notion からの同期のトリガーなどが可能です。

この記事では、Notiondesk API で何ができるのか、誰が利用できるのか、そして最初のリクエストを数分で行う方法について説明します。

Notiondesk API でできること

すぐに使えるスクリプトについては、 「Notiondesk API を使用して一般的なヘルプセンターのタスクを自動化する」を参照してください。

Notiondesk API は誰が使用できますか？

• プラン：エンタープライズプランにはAPIアクセスが含まれています。

• キーの作成：ワークスペースの所有者と管理者は、ダッシュボードでAPIキーを作成します。

• 権限:キーやアプリは、ワークスペース内でそのキーやアプリを使用するユーザーができること以上のことは決してできません。APIキーを使用して Notiondesk API で認証する方法を参照してください。

最初のNotiondesk APIリクエストを実行してください

1. APIキーを作成する

Notiondesk ダッシュボードで、 [設定] 、 [開発者] > [API キー] の順に開き、 [キーの作成]をクリックします。ラベルを付け、読み取り範囲を選択し、表示されたキーをコピーします。キーは nd_wsk_ で始まり、一度だけ表示されます。

環境変数に保存してください。

2. ヘルプセンターの一覧を表示する

応答には、ワークスペース内のすべてのヘルプセンターが表示されます。

3. ヘルプセンターの記事一覧を表示する

これで完了です！あなたはコードからヘルプセンターを読み込んでいます。

Notiondesk 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 または Workspace MCP ですか？

Notiondesk では、ダッシュボード以外からヘルプセンターを操作する方法が 2 つ用意されています。どちらも異なる方法で同じ機能にアクセスできます。

Notiondesk APIエンドポイント

よくある質問

次は？

• APIキーを使用してNotiondesk APIで認証します。

• OAuthを使用してアプリをNotiondeskに接続します。

• Notiondesk APIエラー、レート制限、および再試行を処理する

• Notiondesk API を使用して、ヘルプセンターの一般的なタスクを自動化します。