Formato del error
La API de administración/v1 devuelve los errores como un detalle de problema RFC 9457, servido con el tipo de contenido application/problem+json. Las rutas de webhook responden en el formato configurado de su disparador. Consulta Errores en las rutas de webhook.
Definiciones de los campos
code– El código de error estable de Flowker. Ramifica tu integración sobre este campo.type– Un URI que identifica el error. Siempre eshttps://errors.lerian.studio/v1/más elcode.title– La frase de motivo HTTP estándar parastatus, 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 para personas de esta ocurrencia. Las respuestas con un estado de 500 o superior llevan en cambio un mensaje genérico fijo, así que usacodepara diferenciarlas.instance– Un URI que identifica esta ocurrencia específica, cuando el endpoint proporciona uno.errors– Un arreglo opcional de entradas por campo. Consulta Detalles de error por campo.
Detalles de error por campo
Cuando una solicitud falla la validación en campos específicos, el detalle de problema lleva un arregloerrors. Cada entrada nombra la entrada problemática.
location (dónde está el problema, como body.nodes o path.id), un message, y el value problemático cuando es seguro repetirlo.
Errores en las rutas de webhook
Una ruta de webhook responde en el formato configurado de su disparador. 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. Ramifica tu integración sobre este campo.title– La frase de motivo HTTP para el estado de la respuesta, comoNot FoundoPayload Too Large.message– Una explicación legible para personas de esta ocurrencia.
<error>, porque toda la ruta funciona en XML.
code lleva un código de Flowker de las tablas siguientes, o uno de 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 la solicitud
La API devuelve estos errores cuando la solicitud no cumple con los requisitos de validación.
Errores de entidad
Errores de workflow
Errores de condición de workflow
La API devuelve estos errores cuando el objeto
condition estructurado de un nodo falla la validación durante la creación o actualización del workflow.
Errores de catálogo, ejecutor y disparador
Errores de configuración de ejecutor
Errores de configuración de proveedor
Errores de configuración de proveedor de OpenAPI externo
Estos errores se aplican a las configuraciones de proveedor de tipo
external_openapi, que llaman a una operación declarada por un schema de OpenAPI almacenado.
Errores de binding de schema del proveedor
Errores de ejecución de workflow
Errores de solicitud saliente
Estos errores ocurren mientras un nodo llama a un servicio externo. Aparecen como fallas de nodo en los detalles de la ejecución.
Errores de concurrencia
Errores de webhook
Errores de contrato de disparador de webhook
La API devuelve estos errores cuando guardas el
input_contract de un disparador de webhook o activas el workflow. También los devuelve durante la validación de un payload entrante contra el contrato.
Errores de solicitud y configuración de OpenAPI externo
Errores de schema XSD
Errores de schema de OpenAPI externo
Estos errores se aplican a los schemas de OpenAPI que almacenas por tenant y referencias desde disparadores, configuraciones de proveedor y nodos.
Errores del registro de especificaciones de OpenAPI
Estos errores se aplican al registro compartido de especificaciones de OpenAPI, que fija la versión de la especificación que Flowker usa para enriquecer los schemas de salida de un servicio.

