Connectors

Un Connector de Catalyst proporciona una conexión fluida entre Catalyst y un servicio externo de Zoho establecida a través de autenticación Zoho OAuth. Puedes utilizar un connector en tu aplicación de Catalyst si tu lógica de negocio incluye el uso de la API de un servicio externo de Zoho, como la API de Zoho CRM o Zoho WorkDrive.

Catalyst gestiona la conexión almacenando el Access Token que generas en la consola de API de Zoho para una aplicación específica en Catalyst Cache hasta su expiración. Después de que expire, el connector obtendrá automáticamente un nuevo Access Token usando el Refresh Token y lo almacenará en la caché. Cada vez que el Access Token expire, el connector automáticamente obtiene y almacena en caché un nuevo token en segundo plano, liberándote de los esfuerzos de construir la lógica para mantener una conexión ininterrumpida con el servicio externo de Zoho en la lógica de negocio de tu aplicación.

Antes de configurar el connector en tu lógica de negocio Java como se muestra a continuación, necesitarás registrar un nuevo cliente en la consola de API de Zoho, y seguir los pasos para generar un Authorization Code y un Access Token por primera vez. Luego puedes configurar el connector con el Refresh Token recibido, así como otros parámetros OAuth estándar como el Client ID, Client Secret, Authentication URL y Refresh URL que se requieren para refrescar el Access Token automáticamente de manera periódica. También puedes incorporar tu propia lógica en el connector según tus requisitos.

El código a continuación ilustra un connector de Java.

Fragmento de código de ejemplo

import org.json.simple.JSONObject; 
import com.zc.auth.connectors.ZCConnection; 
import com.zc.auth.connectors.ZCConnector;

JSONObject authJson = new JSONObject();
// El objeto JSON contiene el client_id, client_secret, refresh_token y refresh_url
authJson.put("client_id","{client_id}"); 
authJson.put("client_secret","{client_secret}");
authJson.put("auth_url","{auth_url}"); 
authJson.put("refresh_url","{refresh_url}"); 
authJson.put("refresh_in","{refresh_in}"); 
//Si no se proporciona el refresh token, entonces debes proporcionar el código para generar el refresh token
authJson.put("refresh_token","{refresh_token}");
JSONObject connectorJson = new JSONObject(); 
connectorJson.put("CRMConnector",authJson); 
// Puedes crear conectores para múltiples servicios de Zoho 
ZCConnection conn = ZCConnection.getInstance(connectorJson); 
ZCConnector crmConnector = conn.getConnector("CRMConnector"); 
// Obtiene el AccessToken 
String accessToken = crmConnector.getAccessToken();