Excepciones

# Excepciones

Las excepciones son comportamientos defectuosos inesperados que ocurren durante la ejecución de la aplicación. Todos los errores y excepciones en las aplicaciones Catalyst Android son gestionados por enumeraciones llamadas {{%badge%}}{{%bold%}}ZCatalystException{{%/bold%}}{{%/badge%}}, definidas en el paquete Android SDK.

Si ocurre una excepción en tu aplicación, se devuelven las siguientes propiedades de la excepción:

* {{%bold%}}{{%badge%}}code{{%/badge%}}:{{%/bold%}} Identificador único del error
* {{%bold%}}{{%badge%}}errorMsg{{%/badge%}}:{{%/bold%}} Descripción general sobre el error
* {{%bold%}}{{%badge%}}errorDetails{{%/badge%}}:{{%/bold%}} Información adicional sobre el error
* {{%bold%}}{{%badge%}}originalException{{%/badge%}}:{{%/bold%}} La excepción real que fue lanzada

A continuación se muestra una lista de códigos de error comunes lanzados por Catalyst Android SDK y sus descripciones:

<table class="content-table">
<thead>
<tr>
<th class="w30p">Códigos de error</th>
<th class="w70p">Descripciones</th>
</tr>
</thead>
<tbody>
<tr>
<td>INITIALIZATION_ERROR</td>
<td>La inicialización del SDK falló</td>
</tr>
<tr>
<td>LOGIN_ERROR</td>
<td>El proceso de inicio de sesión falló para el usuario</td>
</tr>
<tr>
<td>LOGOUT_FAILED</td>
<td>El proceso de cierre de sesión falló para el usuario</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>No se pudo obtener el token de acceso</td>
</tr>
<tr>
<td>RESPONSE_PARSE_ERROR</td>
<td>La respuesta recibida no es analizable</td>
</tr>
<tr>
<td>NO_NETWORK_AVAILABLE</td>
<td>No hay conectividad de red disponible para realizar la llamada a la API</td>
</tr>
<tr>
<td>API_FAILED</td>
<td>La invocación de la API falló</td>
</tr>
<tr>
<td>INVALID_DATA</td>
<td>Los datos enviados no son de un tipo válido para el formato específico</td>
</tr>
<tr>
<td>FILE_SIZE_EXCEEDED</td>
<td>El tamaño del archivo subido excedió el límite de 100 MB</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>No se pudo ejecutar la función</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>El cuerpo incluido en la solicitud no es un JSON válido</td>
</tr>
<tr>
<td>INVALID_REQUEST</td>
<td>La solicitud creada no es válida</td>
</tr>
<tr>
<td>INVALID_FILE_INPUT</td>
<td>El archivo enviado en la operación de carga no es válido</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>Ocurrió un error interno en el SDK</td>
</tr>
<tr>
<td>INVALID_CONFIGURATION</td>
<td>El SDK no se ha inicializado con la configuración requerida para el inicio de sesión. Reinicializa el SDK con la configuración apropiada para el inicio de sesión.</td>
</tr>
<tr>
<td>CUSTOM_LOGIN_DISABLED</td>
<td>No se pudieron encontrar los parámetros necesarios para la autenticación de terceros. Asegúrate de haber habilitado la autenticación de terceros para el proyecto o vuelve a descargar el archivo de propiedades.</td>
</tr>
</tbody>
</table>

Las excepciones son comportamientos defectuosos inesperados que ocurren durante la ejecución de la aplicación. Todos los errores y excepciones en las aplicaciones Catalyst Android son gestionados por enumeraciones llamadas ZCatalystException, definidas en el paquete Android SDK.

Si ocurre una excepción en tu aplicación, se devuelven las siguientes propiedades de la excepción:

code: Identificador único del error
errorMsg: Descripción general sobre el error
errorDetails: Información adicional sobre el error
originalException: La excepción real que fue lanzada

A continuación se muestra una lista de códigos de error comunes lanzados por Catalyst Android SDK y sus descripciones:

Códigos de error	Descripciones
INITIALIZATION_ERROR	La inicialización del SDK falló
LOGIN_ERROR	El proceso de inicio de sesión falló para el usuario
LOGOUT_FAILED	El proceso de cierre de sesión falló para el usuario
TOKEN_FETCH_ERROR	No se pudo obtener el token de acceso
RESPONSE_PARSE_ERROR	La respuesta recibida no es analizable
NO_NETWORK_AVAILABLE	No hay conectividad de red disponible para realizar la llamada a la API
API_FAILED	La invocación de la API falló
INVALID_DATA	Los datos enviados no son de un tipo válido para el formato específico
FILE_SIZE_EXCEEDED	El tamaño del archivo subido excedió el límite de 100 MB
FUNCTION_EXECUTION_ERROR	No se pudo ejecutar la función
JSON_EXCEPTION	El cuerpo incluido en la solicitud no es un JSON válido
INVALID_REQUEST	La solicitud creada no es válida
INVALID_FILE_INPUT	El archivo enviado en la operación de carga no es válido
INTERNAL_ERROR	Ocurrió un error interno en el SDK
INVALID_CONFIGURATION	El SDK no se ha inicializado con la configuración requerida para el inicio de sesión. Reinicializa el SDK con la configuración apropiada para el inicio de sesión.
CUSTOM_LOGIN_DISABLED	No se pudieron encontrar los parámetros necesarios para la autenticación de terceros. Asegúrate de haber habilitado la autenticación de terceros para el proyecto o vuelve a descargar el archivo de propiedades.

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Developer Tools