Skip to main content

Formato del error

La API de gestión /v1 devuelve los errores como un documento de problema RFC 9457, servido con el tipo de contenido application/problem+json. Las rutas de webhook responden en el formato que su trigger tiene configurado — consulta Errores en rutas de webhook.

Definiciones de campos

  • code – El código de error estable de Flowker. Usa este campo para ramificar tu integración.
  • type – Un URI que identifica el error. Siempre es https://errors.lerian.studio/v1/ seguido del code.
  • title – La frase de estado HTTP estándar de status, como Not Found o Conflict. No cambia según el código de error.
  • status – El código de estado HTTP, repetido en el cuerpo.
  • detail – Una explicación legible de esta ocurrencia. Las respuestas con estado 500 o superior llevan un mensaje genérico fijo, así que usa code para distinguirlas.
  • instance – Un URI que identifica esta ocurrencia específica, cuando el endpoint lo proporciona.
  • errors – Un arreglo opcional con entradas por campo. Consulta Detalles de errores a nivel de campo.

Detalles de errores a nivel de campo

Cuando una solicitud falla la validación en campos específicos, el documento de problema incluye un arreglo errors. Cada entrada identifica el dato que causó el problema.
Cada entrada lleva un location (dónde está el problema, como body.nodes o path.id), un message y el value que causó el error cuando es seguro incluirlo.

Errores en rutas de webhook

Una ruta de webhook responde en el formato que su trigger tiene configurado. Una ruta de webhook JSON devuelve un objeto de error compacto con el tipo de contenido application/json:
  • code – El código de error estable de Flowker, tomado de las tablas siguientes. Basa las ramas de tu integración en este campo.
  • title – La frase de estado HTTP correspondiente al status de la respuesta, como Not Found o Payload Too Large.
  • message – Una explicación legible de esta ocurrencia.
Una ruta de webhook XML devuelve un documento <error> en su lugar, porque toda la ruta trabaja en XML.
El elemento code lleva un código de Flowker de las tablas siguientes o uno de los dos códigos específicos de XML:

Errores generales


Estos errores se aplican a todos los endpoints de la API de Flowker.

Errores de validación de solicitudes


Estos errores se devuelven cuando la solicitud a la API no cumple con los requisitos de validación.

Errores de entidad


Errores de workflow


Errores de condición de workflow


Estos errores se devuelven cuando el objeto condition estructurado de un node falla la validación al crear o actualizar el workflow.

Errores de catálogo, executors y triggers


Errores de configuración de executor


Errores de configuración de provider


Errores de configuración de provider OpenAPI externo


Estos errores se aplican a las configuraciones de provider de tipo external_openapi, que llaman a una operación declarada por un esquema OpenAPI almacenado.

Errores de vinculación de esquemas de provider


Errores de ejecución de workflows


Errores de solicitudes salientes


Estos errores se producen mientras un node llama a un servicio externo. Aparecen como fallos de node en los detalles de la ejecución.

Errores de concurrencia


Errores de webhook


Errores de contrato de trigger de webhook


Estos errores se devuelven al guardar el input_contract de un trigger de webhook, al activar el workflow, o al validar una carga entrante contra él.

Errores de esquemas XSD


Errores de esquemas OpenAPI externos


Estos errores se aplican a los esquemas OpenAPI que almacenas por tenant y referencias desde triggers, configuraciones de provider y nodes.

Errores del registro de especificaciones OpenAPI


Estos errores se aplican al registro compartido de especificaciones OpenAPI, que fija la versión de la especificación que Flowker usa para enriquecer los esquemas de salida de un servicio.

Errores de ocurrencias programadas