Respuestas y excepciones

APIResponse, BulkAPIResponse y FileAPIResponseson los objetos contenedores de las respuestas de API de Zoho CRM. Con todos los métodos de solicitudes API, se devuelve uno de estos dos objetos.

  • Con una entidad de búsqueda de método, se devuelve el objeto APIResponse, mientras que con una lista de entidades de búsqueda de método, se devuelve el objeto BulkAPIResponse.
  • FileAPIResponse se devolverá para las API de descarga de archivos, a fin de descargar una foto o un archivo adjunto de un registro o nota, como record.downloadPhoto,record.downloadAttachment etc.
  • Utilice el método getData() para obtener los datos de la entidad independiente de los objetos contenedores de respuesta.APIResponse.getData() devolverá un solo objeto de entidad Zoho CRM, mientras que BulkAPIResponse.getData() devolverá una lista de objetos de entidad Zoho CRM.
  • FileAPIResponse tiene dos métodos definidos como FileAPIResponse.getFileName(), que devuelve el nombre del archivo que se descarga, y FileAPIResponse.getFileAsStream(), que proporciona el contenido del archivo como InputStream.

Además de los datos, estos objetos contenedores de respuesta tienen las siguientes propiedades:

  1. ResponseHeaders: recuento de API faltantes del día/plazo presente y el tiempo transcurrido del restablecimiento del plazo presente.
  2. ResponseInfo: cualquier otro tipo de información, si la API la proporciona, además de los datos reales.
  3. List<EntityResponse>: estado de las entidades individuales en una Bulk API. Por ejemplo: es posible que se produzca un error parcial en una API de ingreso de registros, debido a unos cuantos registros. Esta matriz proporciona el estado de creación de los registros individuales.

Inicio de la aplicación

SDK requiere la invocación de la siguiente línea de código cada vez que la aplicación se inicie.

ZCRMRestClient.initialize();

Este método se debe solicitar de la clase principal de la aplicación Java para iniciar la aplicación. Se debe invocar sin ninguna excepción.

Verificación de excepciones

A todos los comportamientos inesperados, como respuestas API incorrectas y errores de SDK, los administra el SDK y se producen como una sola excepción: ZCRMException. Por lo tanto, es suficiente para captar esta excepción por sí sola en el código de aplicación del cliente.