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 eshttps://errors.lerian.studio/v1/seguido delcode.title– La frase de estado HTTP estándar destatus, comoNot FoundoConflict. 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 usacodepara 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 arregloerrors. Cada entrada identifica el dato que causó el problema.
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 contenidoapplication/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, comoNot FoundoPayload Too Large.message– Una explicación legible de esta ocurrencia.
<error> en su lugar, porque toda la ruta trabaja en XML.
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.

