Connectors

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

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

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

以下のコードはPythonコネクターを示しています。以下で使用されているapp参照は、SDKの初期化時にレスポンスとして返されるPythonオブジェクトです。レスポンスはアクセストークンを返します：

使用パラメータ

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パラメータを設定する
        }
    }
).get_connector("{ConnectorName}")
#作成するコネクタごとに一意のコネクタ名を指定する
access_token = connector.get_access_token()