「API設定」ページで、APIへのパスワードアクセスとAPIトークンによるアクセスを有効にできます。OAuthアクセスについては、「アプリケーションでのOAuth認証の使用」を参照してください。Zendesk APIの詳細については、Zendesk開発者向けドキュメントを参照してください。

現在のプランを確認
Suite、すべてのバージョン Team、Growth、Professional、EnterpriseまたはEnterprise Plus
Support Team、ProfessionalまたはEnterprise

要約：◀▼

利用規約に同意し、APIトークンまたはパスワードによるアクセスを有効にすることで、APIアクセスを利用できるようになります。APIトークンを使用すると、エージェントのパスワードを直接使用せずに済みます。また、APIトークンは使用前に有効にする必要があります。エンドユーザーについては、認証済みまたは匿名のAPIリクエストに対して、パスワードによるアクセスのオン/オフを切り替えることができます。トークンまたはパスワードによるアクセスを無効にすると、それらの認証方法は使用できなくなり、再度使用するには再有効化が必要です。OAuthアクセスは別途管理されます。

ナビゲーションパス： 「管理センター」>「アプリおよびインテグレーション」>「API」>「API設定」
ユーザーは、次のいずれかの認証方法を使用してZendesk APIにアクセスできます。
  • 自動生成されるAPIトークンを使用する。
  • APIトークンとは異なる OAuth アクセストークンを使用する。
  • エンドユーザーの場合、APIパスワードアクセスを使用して、認証済みまたは未認証のAPIリクエストを送信できる。

「API設定」ページで、APIへのパスワードアクセスとAPIトークンによるアクセスを有効にできます。OAuthアクセスについては、「アプリケーションでのOAuth認証の使用」を参照してください。Zendesk APIの詳細については、Zendesk開発者向けドキュメントを参照してください。

この記事では、以下のトピックについて説明します。

  • APIアクセスをアクティブにする
  • APIトークンによるアクセスのオンとオフを切り替える
  • エンドユーザーのAPIパスワードアクセスの有効化と無効化

関連記事

  • Zendesk APIへのアクセス管理
  • 開発者のドキュメント：セキュリティと認証

APIアクセスをアクティブにする

Zendesk APIに初めてアクセスする場合は、Zendeskの利用規約およびApplication Developer and API Agreement（アプリケーション開発者とAPIの契約）に同意する必要があります。

APIアクセスをアクティブにするには

  1. 管理センターで、サイドバーの「 アプリおよびインテグレーション」をクリックし、「API」>「API設定」を選択します。
  2. チェックボックスをクリックして、利用規約と契約に同意します。
  3. 「はじめましょう」をクリックします。

APIトークンによるアクセスのオンとオフを切り替える

APIトークンを使用して、エージェントのパスワードを安全に保持します。トークンで認証する場合は、メールアドレスの最後に/tokenを追加してください。APIトークンによるアクセスは、デフォルトでは無効になっています。ユーザーがAPIトークンを使用できるようにするには、APIトークンによるアクセスを有効にする必要があります。

APIへのトークンアクセスを有効にするには

  1. 管理センターで、サイドバーの「 アプリおよびインテグレーション」をクリックし、「API」>「API設定」を選択します。
  2. 「APIトークンアクセスを許可」を選択します。
  3. 「保存」をクリックします。

APIトークンによるアクセスをオンにすると、APIアクセストークンを生成できるようになります。詳しくは「APIトークンを生成する」を参照してください。

APIトークンアクセスを無効にするには

  1. 管理センターで、サイドバーの「 アプリおよびインテグレーション」をクリックし、「API」>「API設定」を選択します。
  2. 「APIトークンアクセスを許可」の選択を解除します。
  3. 「保存」をクリックします。

トークンアクセスをオフにすると、トークンは機能しなくなります。トークンアクセスを再び有効にするには、トークンアクセスをオンに戻す必要があります。

エンドユーザーのAPIパスワードアクセスの有効化と無効化

メモ：一部の旧アカウントには、APIトークンアクセスに加えて、チームメンバー向けのAPIパスワードアクセスを有効化する設定が残っている場合があります。チームメンバーのAPIパスワードアクセスは非推奨となり、新規アカウントではサポートされません。

デフォルトでは、エンドユーザーのAPIパスワードアクセスは無効になっています。そのため、エンドユーザーからのアクセスは匿名アクセスとして扱われます。

2要素認証を有効にしても、必須設定かエンドユーザーによる任意登録かにかかわらず、メールアドレスとパスワードを使用したAPIリクエストの実行には影響しません。

エンドユーザーのAPIパスワードアクセスを有効にするには

  1. 管理センターで、サイドバーの「 アプリおよびインテグレーション」をクリックし、「API」>「API設定」を選択します。
  2. 「エンドユーザーにパスワードアクセスを許可する」を選択します。
  3. 「保存」をクリックします。

APIパスワードアクセスを有効にすると、エンドユーザーは、APIリクエストを認証済みまたは匿名にできます。

エンドユーザーのAPIパスワードアクセスを無効にするには

  1. 管理センターで、サイドバーの「 アプリおよびインテグレーション」をクリックし、「API」>「API設定」を選択します。
  2. 「エンドユーザーにパスワードアクセスを許可する」の選択を解除します。
  3. 「保存」をクリックします。

APIパスワードアクセスを無効にすると、エンドユーザーからのアクセスは匿名アクセスとして扱われます。

Powered by Zendesk