認証トークンの使用

Zoho CRM API は、Zoho CRMの全プランで使用できます。APIを使用するには、CRMアカウントのZoho CRM認証トークンが必要です。APIサービスへのアクセス権限があることを確認してください。権限がない場合は、CRM管理者にお問い合わせください。

認証トークンの生成

認証トークンを生成するには、下記のURL形式を使用して、認証リクエストをZoho Accountsに送信する必要があります。ご自分が認証済みユーザーであることを確かめてください。認証済みユーザーでない場合、認証トークンの生成中に「ACCOUNT_REGISTRATION_NOT_CONFIED」エラーが発生することがあります。

URL形式

APIモード：

APIモードで認証トークンを生成するには、次の操作を行ってください。

1. Zoho CRMにサインインしてください。
2. https://accounts.zoho.comを開いてください。
3. Zoho Accountsのホームページで、［2段階認証］をクリックしてください。
4. ［2段階認証］ページで、［アプリケーション専用のパスワードの管理］をクリックしてください。
   
5. ［アプリケーション専用のパスワード］ポップアップで、次の操作を行ってください。
   1. デバイス名またはアプリケーション名を入力してください。
   2. 現在のパスワードを入力してください。
   3. ［作成］をクリックしてください。スペースを含む、新しいアプリケーション固有のパスワードが送信されます。
6. 認証トークンを生成するには、パスワードのスペースを削除し、次のAPIモードURLを含めます。

このURLとともに渡されるパラメーターは、以下のとおりです。

詳細については、2段階認証のヘルプページを参照してください。

レスポンス例

例

データを取得する例を、以下に示します。

認証トークンの取り消し

アカウント用に生成された認証トークンは、［Zohoアカウント］ページから削除できます。

1. Zoho CRMにサインインしてください。
2. ［ユーザー名］ > ［マイ・アカウント］の順に開いてください。
3. ［取引先］ページで、［有効な認証トークン］をクリックしてください。
4. ［有効な認証トークン］ページで、認証トークンを［削除］（取り消し）できます。

留意点

• 認証トークンは、ユーザー固有の永続的なトークンです。
• 削除すると、既存のトークンは完全に削除されます。すべてのAPI呼び出しで、新しいトークンに置き換える必要があります。
• ユーザーが無効にされると、ユーザーのアカウントの認証トークンは無効になります。
• 組織がAPI制限を超えた場合は、CRMユーザー（認証トークンを生成したユーザー）に通知されます。
• アプリケーションで上限を超える呼び出しが必要でも、追加のAPIリクエストは処理されません。データ転送の問題を回避するには、API要件を事前に評価してください。サポートが必要な場合は、Zohoのサポート窓口（support@zohocrm.com）までお問い合わせください（英語対応）。