Catalyst Connectors

Catalyst Connectorは、**Zoho OAuth認証**を通じて確立されるCatalystと外部Zohoサービス間のシームレスな接続を提供します。ビジネスロジックにZoho CRMやZoho WorkDrive APIなどの外部ZohoサービスのAPIの使用が含まれる場合、Catalystアプリケーションでコネクターを利用できます。

Catalystは、Zoho APIコンソールで特定のアプリケーション用に生成したアクセストークンを、有効期限が切れるまでCatalyst Cacheに保存することで接続を処理します。有効期限が切れると、コネクターはリフレッシュトークンを使用して新しいアクセストークンを自動的に取得し、キャッシュに保存します。アクセストークンが期限切れになるたびに、コネクターがバックグラウンドで自動的に新しいトークンを取得してキャッシュするため、アプリケーションのビジネスロジックで外部Zohoサービスとの中断のない接続を維持するロジックを構築する手間が省けます。

以下に示すようにNode.jsのビジネスロジックでコネクターを設定する前に、Zoho APIコンソールで新しいクライアントを登録し、初回の認可コードとアクセストークンを生成する手順に従う必要があります。その後、受け取ったリフレッシュトークンと、Client ID、Client Secret、認証URL、リフレッシュURLなど、アクセストークンを定期的に自動更新するために必要な標準的なOAuthパラメーターを使用してコネクターを設定できます。また、要件に応じてコネクターに独自のロジックを組み込むこともできます。

以下のコードは、Node.jsコネクターを示しています。ここで返されるPromiseは、アクセストークン文字列に解決されます。

 var connector = app.connection({
 ConnectorName: {
   client_id: '{add_client_id}',
   client_secret: '{add_client_secret}',
   auth_url: '{add_auth_url}',
   refresh_url: '{add_refresh_url}',
   refresh_token: '{add_refresh_token}',
   refresh_in: '{add_refresh_in}'
   //Zoho APIコンソールでアプリを登録し認証コードを生成した後に返された値からOAuthパラメータを設定する
  }
 })
 .getConnector('{ConnectorName}'); //Provide a unique connector name for each connector you create
 connector.getAccessToken().then((accessToken) => {
// カスタムロジックをここに追加する
});