Skip to main content

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 es https://errors.lerian.studio/v1/ más el code.
  • title – La frase de motivo HTTP estándar para 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 para personas de esta ocurrencia. Las respuestas con un estado de 500 o superior llevan en cambio un mensaje genérico fijo, así que usa code para 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 arreglo errors. Cada entrada nombra la entrada problemática.
Cada entrada lleva un 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 contenido application/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, como Not Found o Payload Too Large.
  • message – Una explicación legible para personas de esta ocurrencia.
Una ruta de webhook XML devuelve en cambio un documento <error>, porque toda la ruta funciona en XML.
El elemento 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.

Errores de ocurrencia programada