Códigos

Códigos y eventos

Estados HTTP

El estado HTTP indica la clase del resultado. El código exacto depende del flujo y de la configuración del entorno.

Estado	Significado	Qué hacer
`200`	Operación completada.	—
`206`	El inicio de sesión requiere una etapa de MFA.	Complete el desafío mediante el `linkURL`. Consulte Completar el MFA.
`302`, `307`	Redirección, común en los flujos SSO.	Siga la redirección en el navegador.
`400`	Solicitud, parámetro, enlace o grant no válido.	Revise los campos obligatorios y los valores enviados.
`401`	Credencial o token no aceptado.	Vuelva a autenticarse y repita la llamada.
`403`	Acceso denegado: permiso, regla operativa, proveedor no autorizado o host diferente del configurado.	Revise el host y las reglas de acceso.
`404`	Archivo, enlace o recurso no encontrado.	Verifique que el archivo siga disponible y que el enlace no haya expirado.
`405`	Método HTTP no aceptado por la ruta.	Use uno de los métodos indicados en la referencia.
`503`	Servicio externo de validación no disponible, por ejemplo Cloudflare Turnstile en el inicio de sesión.	Inténtelo de nuevo; si persiste, contacte al administrador.

Formato de los errores

El formato del cuerpo de error varía entre endpoints. No dependa de una estructura JSON única: trate primero el estado HTTP y, si la hay, use la descripción devuelta.

Errores de emisión de token

/auth/token y /oauth2/token responden 400 con el modelo OAuthError:

{
  "error": 400,
  "error_description": "<motivo>",
  "error_uri": "<uri-de-la-api>"
}

El valor numérico de error describe la condición informada por la validación.

Eventos de sesión y transferencia

Las operaciones generan eventos de inicio y de finalización. Los identificadores siguientes ayudan a interpretar los registros del informe y los registros exportados por el entorno.

Código	Evento	Momento
`0`	`STCPEVTSTARTSESSIONIN`	Inicio de una sesión de entrada autenticada.
`1`	`STCPEVTENDSESSIONIN`	Finalización explícita de la sesión.
`6`	`STCPEVTSTARTRECEIVEFILE`	Inicio de la recepción de un archivo (envío).
`7`	`STCPEVTENDRECEIVEFILE`	Finalización del procesamiento del envío.
`4`	`STCPEVTSTARTSENDFILE`	Inicio del envío de un archivo (descarga).
`5`	`STCPEVTENDSENDFILE`	Finalización del envío del archivo.

En el informe (/report), filterdirection=5 selecciona los eventos STCPEVTENDSENDFILE (descargas concluidas) y filterdirection=7, los eventos STCPEVTENDRECEIVEFILE (cargas concluidas).

Nota

El registro de inicio no garantiza que la operación se haya completado. Un error durante el procesamiento puede generar el evento inicial sin el evento final correspondiente.

Modelos