> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Lista de errores de Flowker > Las APIs de Flowker devuelven documentos de problema RFC 9457 con un código de error estable, lo que simplifica el diagnóstico de problemas. ### Formato del error La API de gestión `/v1` devuelve los errores como un documento de problema [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457), 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](#errores-en-rutas-de-webhook). ```json theme={null} { "type": "https://errors.lerian.studio/v1/FLK-0110", "title": "Bad Request", "status": 400, "detail": "name is a required field", "instance": "/v1/workflows", "code": "FLK-0110" } ``` ### 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). ### 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. ```json Ejemplo 1 theme={null} { "type": "https://errors.lerian.studio/v1/FLK-0301", "title": "Unprocessable Entity", "status": 422, "detail": "validation failed", "code": "FLK-0301", "errors": [ { "location": "body.name", "message": "expected required property name to be present" } ] } ``` ```json Ejemplo 2 theme={null} { "type": "https://errors.lerian.studio/v1/FLK-0001", "title": "Bad Request", "status": 400, "detail": "request body is invalid or malformed", "code": "FLK-0001", "errors": [ { "location": "body.nodes", "message": "expected array length >= 1", "value": [] } ] } ``` 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`: ```json theme={null} { "code": "FLK-0361", "title": "Not Found", "message": "no webhook registered for this path and method" } ``` * **`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 `` en su lugar, porque toda la ruta trabaja en XML. ```xml theme={null} XML_VALIDATION_FAILED element 'valor' is not a valid decimal
line 12, column 5
018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8 ``` El elemento `code` lleva un código de Flowker de las tablas siguientes o uno de los dos códigos específicos de XML: | Código | Qué significa | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `XML_MALFORMED` | El cuerpo de la solicitud no es XML bien formado. Se devuelve con HTTP 400. | | `XML_VALIDATION_FAILED` | El cuerpo es XML bien formado pero no cumple el XSD de la ruta. Se devuelve con HTTP 422, y `details` lleva la línea y la columna del primer hallazgo. | ## Errores generales *** Estos errores se aplican a todos los endpoints de la API de Flowker. | Código | Qué significa | | -------- | ------------------------------------------------------------------------------------------------------- | | FLK-0001 | El cuerpo de la solicitud es inválido o está malformado. Verifica el formato JSON e inténtalo de nuevo. | | FLK-0002 | El ID proporcionado no es un UUID válido. Verifica el ID e inténtalo de nuevo. | | FLK-0003 | Se requiere autenticación para acceder a este recurso. Envía un token bearer válido. | | FLK-0004 | No tienes permiso para realizar esta acción. Revisa los permisos concedidos a tu token. | | FLK-9999 | Ocurrió un error inesperado. Inténtalo más tarde o contacta al soporte si el problema persiste. | ## Errores de validación de solicitudes *** Estos errores se devuelven cuando la solicitud a la API no cumple con los requisitos de validación. | Código | Qué significa | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0300 | La solicitud contiene campos inesperados. Elimina los campos adicionales e inténtalo de nuevo. | | FLK-0301 | Faltan uno o más campos obligatorios. Proporciona todos los campos requeridos e inténtalo de nuevo. | | FLK-0302 | La solicitud es inválida. Verifica el formato de la solicitud e inténtalo de nuevo. | | FLK-0303 | Un campo usado en un cálculo tiene un tipo inválido. Verifica los tipos de los campos e inténtalo de nuevo. | | FLK-0304 | Uno o más parámetros de consulta son inválidos. Verifica los parámetros e inténtalo de nuevo. | | FLK-0305 | La fecha debe estar en formato RFC 3339 con zona horaria, como `2026-01-28T10:30:00Z`. Las fechas sin hora se rechazan. | | FLK-0306 | La fecha final debe ser posterior a la inicial. Proporciona un rango de fechas válido. | | FLK-0307 | El rango de fechas solicitado excede el período máximo permitido. Reduce el rango de fechas. | | FLK-0308 | El rango de fechas es inválido. Verifica las fechas de inicio y fin. | | FLK-0309 | El parámetro `limit` excede el valor máximo permitido. Reduce el límite e inténtalo de nuevo. | | FLK-0310 | El orden debe ser `ASC` o `DESC`. Proporciona un valor válido. | | FLK-0311 | El parámetro de ruta proporcionado es inválido. Verifica el valor del parámetro e inténtalo de nuevo. | | FLK-0312 | La clave de metadatos excede la longitud máxima permitida de 64 caracteres. Reduce el tamaño de la clave. | | FLK-0313 | El valor de metadatos excede la longitud máxima permitida. Reduce el tamaño del valor. | | FLK-0314 | Los valores de metadatos no pueden ser objetos anidados. Proporciona pares clave-valor planos. | | FLK-0315 | Los metadatos exceden el número máximo de entradas. Reduce el número de entradas de metadatos. | | FLK-0321 | El cursor de paginación está malformado o no se pudo decodificar. Solicita la primera página de nuevo y sigue el cursor que devuelve la API. | ## Errores de entidad *** | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------------------- | | FLK-0400 | La entidad solicitada no existe. Verifica el ID e inténtalo de nuevo. | | FLK-0401 | Esta acción no está permitida en el estado actual. Revisa el estado del recurso e inténtalo de nuevo. | | FLK-0402 | La entidad padre referenciada no existe. Verifica el ID del padre e inténtalo de nuevo. | ## Errores de workflow *** | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0100 | El workflow solicitado no existe. Verifica el ID del workflow e inténtalo de nuevo. | | FLK-0101 | Ya existe un workflow con este nombre. Elige un nombre diferente e inténtalo de nuevo. | | FLK-0102 | La transición de estado solicitada no está permitida. Revisa el estado actual del workflow y las transiciones válidas. | | FLK-0103 | Los workflows que no están en borrador no se pueden modificar. Crea una nueva versión o devuelve el workflow a borrador. | | FLK-0104 | Un node referencia un executor del catálogo que no existe. Verifica el `executorId` del node. | | FLK-0105 | La expresión condicional es inválida o no se pudo evaluar. Verifica la sintaxis de la expresión. | | FLK-0110 | El campo `name` es obligatorio. Proporciona un nombre para el workflow e inténtalo de nuevo. | | FLK-0111 | El nombre del workflow excede la longitud máxima permitida. Reduce el tamaño del nombre. | | FLK-0112 | Un workflow debe tener al menos un node. Agrega nodes al workflow e inténtalo de nuevo. | | FLK-0113 | El workflow excede el número máximo de nodes permitidos. Reduce la cantidad de nodes. | | FLK-0114 | El workflow excede el número máximo de edges permitidos. Reduce la cantidad de edges. | | FLK-0115 | Un edge referencia un node que no existe en el workflow. Verifica los valores de origen y destino de todos los edges. | | FLK-0116 | El workflow debe tener al menos un node de trigger. Agrega un trigger e inténtalo de nuevo. | | FLK-0117 | El trigger de agenda lleva una expresión cron inválida. Usa un cron estándar de 5 campos. Las agendas por debajo del minuto no son compatibles. | | FLK-0118 | El workflow no tiene trigger de agenda, así que no hay ocurrencias futuras que listar o gestionar. | | FLK-0120 | Cada node debe tener un ID. Proporciona un ID para todos los nodes. | | FLK-0121 | Cada node debe tener un tipo. Proporciona un tipo para todos los nodes. | | FLK-0122 | El `responseStatusCode` de un node de acción `set_output` debe ser un entero entre 200 y 599. Corrige el valor e inténtalo de nuevo. | | FLK-0130 | Cada edge debe tener un ID. Proporciona un ID para todos los edges. | | FLK-0131 | Cada edge debe especificar un node de origen. Proporciona el ID del node de origen. | | FLK-0132 | Cada edge debe especificar un node de destino. Proporciona el ID del node de destino. | | FLK-0140 | La configuración de mapeo de entrada es inválida. Verifica la sintaxis del mapeo y las referencias a campos. | | FLK-0141 | La configuración de mapeo de salida es inválida. Verifica la sintaxis del mapeo y las referencias a campos. | | FLK-0142 | La configuración de transformación es inválida. Verifica las expresiones de transformación. | | FLK-0143 | La plantilla `data.body` de un node no se pudo resolver contra el contexto del workflow, porque una referencia `${...}` está malformada o no se resuelve. El node falla sin llamar al servicio externo. | | FLK-0150 | El `providerConfigId` del node está ausente, no es un UUID válido, o nombra una configuración de provider que no existe o no está activa. Verifica el `providerConfigId` de cada node executor, y la existencia y el estado de la configuración que nombra. | | FLK-0151 | Un node combina una configuración de provider de un provider con un executor de otro. Verifica que el `providerId` de la configuración y el `executorId` del node nombren el mismo provider del catálogo. | ## 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. | Código | Qué significa | | -------- | --------------------------------------------------------------------------------------------------------------------- | | FLK-0160 | Falta el campo `version` de la condición o su valor no es `2`. | | FLK-0161 | El objeto de condición está malformado estructuralmente, por ejemplo un valor `cases` que no es un arreglo. | | FLK-0162 | La condición no tiene casos. Agrega al menos un caso. | | FLK-0163 | Dos casos, o un caso y la rama por defecto, comparten el mismo ID de salida. Asigna un ID único a cada rama. | | FLK-0164 | Un caso tiene el ID de salida vacío. Proporciona un ID para cada caso. | | FLK-0165 | El `mode` de la condición debe ser `rules` o `value`. | | FLK-0166 | Una condición en modo `value` necesita un operando sujeto. Proporciona el sujeto. | | FLK-0167 | El `combinator` de un grupo debe ser `and` u `or`. | | FLK-0168 | Un grupo no tiene reglas ni grupos anidados. Agrega al menos una regla o elimina el grupo. | | FLK-0169 | El operador de la regla no se reconoce. Usa un operador de la taxonomía admitida. | | FLK-0170 | El `valueType` de la regla no se reconoce. Usa un tipo de valor de la taxonomía admitida. | | FLK-0171 | El operador no está permitido para el `valueType` elegido. Cambia el operador o el tipo de valor. | | FLK-0172 | Un operando tiene la ruta `source` vacía. Proporciona la ruta que se debe leer. | | FLK-0173 | Una transformación tiene una operación inválida o parámetros inválidos para su operación. | | FLK-0174 | El `kind` del operando derecho debe ser `literal` o `source`, y un operando derecho `source` necesita una ruta. | | FLK-0175 | La rama por defecto tiene el ID de salida vacío. Proporciona un ID. | | FLK-0176 | La condición excede el número máximo de casos. Reduce la cantidad de casos. | | FLK-0177 | Un grupo excede el número máximo de reglas. Distribuye las reglas en grupos anidados. | | FLK-0178 | La secuencia de transformaciones de un operando excede el máximo. Reduce la secuencia. | | FLK-0179 | Una regla `matchesRegex` o `notMatchesRegex` lleva una expresión regular que excede la longitud máxima. | | FLK-0180 | Una regla `isIn` o `notIn` lleva una lista que excede el número máximo de elementos. | | FLK-0181 | La condición es válida estructuralmente pero no se pudo compilar. Revisa los operandos y literales del node indicado. | | FLK-0182 | El árbol de la condición es demasiado grande sumando todos sus casos. Reduce la cantidad de grupos y reglas. | ## Errores de catálogo, executors y triggers *** | Código | Qué significa | | -------- | ------------------------------------------------------------------------------------------------------------- | | FLK-0200 | El executor solicitado no existe en el catálogo. Verifica el ID del executor e inténtalo de nuevo. | | FLK-0201 | La configuración de un node no cumple el JSON Schema del executor del catálogo. Verifícala contra ese schema. | | FLK-0210 | El trigger solicitado no existe en el catálogo. Verifica el ID del trigger e inténtalo de nuevo. | | FLK-0211 | La configuración del trigger es inválida. Verifica el formato de la configuración. | | FLK-0220 | El runner solicitado no existe. Verifica el ID del runner e inténtalo de nuevo. | | FLK-0230 | El provider solicitado no existe en el catálogo. Verifica el ID del provider e inténtalo de nuevo. | | FLK-0231 | Ya existe un provider con este identificador. Usa el provider existente o elige un ID diferente. | | FLK-0232 | La configuración de provider es inválida. Verifica el formato de la configuración. | | FLK-0240 | La plantilla solicitada no existe en el catálogo. Verifica el ID de la plantilla e inténtalo de nuevo. | | FLK-0242 | Uno o más parámetros de la plantilla son inválidos. Verifícalos contra el esquema de la plantilla. | ## Errores de configuración de executor *** | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0250 | La configuración de executor solicitada no existe. Verifica el ID e inténtalo de nuevo. | | FLK-0251 | Ya existe una configuración de executor con este nombre. Elige un nombre diferente e inténtalo de nuevo. | | FLK-0252 | La configuración de executor no se puede modificar en su estado actual. Revisa el estado e inténtalo de nuevo. | | FLK-0260 | El campo `name` es obligatorio. Proporciona un nombre para la configuración de executor. | | FLK-0261 | El nombre de la configuración de executor excede la longitud máxima permitida. Reduce el tamaño del nombre. | | FLK-0262 | El campo `baseUrl` es obligatorio. Proporciona una URL base para la configuración de executor. | | FLK-0263 | La URL base proporcionada no es una URL válida. Verifica el formato de la URL. | | FLK-0264 | La URL base excede la longitud máxima permitida. Reduce el tamaño de la URL. | | FLK-0265 | Se debe configurar al menos un endpoint. Proporciona las definiciones de los endpoints. | | FLK-0266 | La configuración de autenticación es obligatoria. Proporciona los ajustes de autenticación. | | FLK-0267 | La descripción excede la longitud máxima permitida. Reduce el tamaño de la descripción. | | FLK-0268 | El campo de tipo de autenticación es obligatorio. Proporciona un tipo de autenticación. | | FLK-0269 | El tipo de autenticación no se reconoce. Proporciona un tipo de autenticación válido. | | FLK-0270 | Cada endpoint debe tener un nombre. Proporciona nombres para todos los endpoints. | | FLK-0271 | Cada endpoint debe tener una ruta. Proporciona rutas para todos los endpoints. | | FLK-0272 | Cada endpoint debe especificar un método HTTP. Proporciona métodos para todos los endpoints. | | FLK-0273 | El método HTTP de un endpoint no se reconoce. Verifica el método en cada endpoint e inténtalo de nuevo. | | FLK-0284 | La URL base resuelve a una dirección que Flowker se niega a llamar, como un host loopback o link-local. Usa un host externo enrutable. | | FLK-0285 | El host de la URL base no está permitido por la lista de hosts permitidos de la configuración. Agrega el host a la lista o cambia la URL. | ## Errores de configuración de provider *** | Código | Qué significa | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0290 | La configuración de provider solicitada no existe. Verifica el ID e inténtalo de nuevo. | | FLK-0291 | Ya existe una configuración de provider con este nombre. Elige un nombre diferente e inténtalo de nuevo. | | FLK-0292 | La configuración de provider no se puede modificar en su estado actual. Revisa el estado e inténtalo de nuevo. | | FLK-0293 | El objeto `config` no coincide con el esquema requerido por el provider, o una entrada de `schemaBindings` está malformada: un `type` desconocido, un `schemaId` vacío, que no es un UUID, o formado solo por ceros, `operations` en una vinculación que no es `openapi`, o una operación cuya ruta o método HTTP falta o no es válido. Verifica los campos de la configuración y cada vinculación de esquema. | | FLK-0294 | El provider referenciado no existe en el catálogo. Verifica el ID del provider. | | FLK-0295 | El campo `name` es obligatorio. Proporciona un nombre para la configuración de provider. | | FLK-0296 | El nombre de la configuración de provider excede la longitud máxima permitida. Reduce el tamaño del nombre. | | FLK-0297 | El campo `providerId` es obligatorio en una configuración de provider de kind `catalog`. Proporciona un ID de provider. | | FLK-0298 | El campo `config` es obligatorio. Proporciona el objeto de configuración de provider. | | FLK-0299 | La descripción excede la longitud máxima permitida. Reduce el tamaño de la descripción. | | FLK-0316 | El ID de la configuración de provider es obligatorio para esta operación. Proporciona el ID. | | FLK-0317 | Una entrada de la lista de hosts permitidos no es un host válido. Verifica cada entrada. | | FLK-0320 | Una URL base de la configuración apunta a un host que su propia lista de hosts permitidos rechaza. Alinea la URL y la lista. | | FLK-0323 | Una configuración de provider HTTP genérico debe declarar una lista de hosts permitidos. Una lista vacía permitiría llamadas a cualquier dirección, así que se rechaza. | | FLK-0952 | La actualización cambió el tipo de autenticación sin suministrar una credencial que el nuevo tipo exige y el anterior no exigía. Envía ese valor junto con el cambio de tipo. | ## 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. | Código | Qué significa | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0946 | La configuración omite la referencia obligatoria `config.openapi_schema_id`. Proporciona el ID del esquema. | | FLK-0947 | El esquema OpenAPI referenciado no existe en tu tenant. Verifica el ID del esquema. | | FLK-0948 | El bloque `config.auth` está malformado: un tipo desconocido, un campo obligatorio ausente o una forma incorrecta. | | FLK-0949 | Ni `config.base_url` ni una entrada `servers` utilizable del esquema referenciado resuelven una URL base. El node falla sin llamar al servicio. | | FLK-0950 | La operación vinculada no está en el esquema referenciado, o el esquema almacenado ya no se puede interpretar. El node falla sin llamar al servicio. | | FLK-0951 | El esquema de firma HMAC no pudo resolver su secreto. La solicitud nunca se envía sin firmar. | ## Errores de vinculación de esquemas de provider *** | Código | Qué significa | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0942 | Una vinculación de esquema referencia un ID de esquema XSD u OpenAPI que no existe en tu tenant. Verifica el ID. | | FLK-0943 | Una vinculación de esquema OpenAPI se restringe a una operación que el documento referenciado no declara. Verifica la ruta y el método. | | FLK-0944 | La configuración lista la misma vinculación dos veces. Elimina la duplicada. | | FLK-0945 | El esquema no se puede eliminar porque al menos una configuración de provider activa lo vincula. La respuesta lista las configuraciones de provider y los workflows que lo referencian. | ## Errores de ejecución de workflows *** | Código | Qué significa | | -------- | --------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0500 | La ejecución solicitada no existe. Verifica el ID de la ejecución e inténtalo de nuevo. | | FLK-0501 | El workflow no está activo y no se puede ejecutar. Actívalo e inténtalo de nuevo. | | FLK-0502 | Una ejecución anterior de este workflow sigue en curso. Espera a que termine. | | FLK-0503 | La ejecución del workflow excedió el tiempo límite. Revisa la lógica del workflow y los tiempos de respuesta de los servicios externos. | | FLK-0504 | Un node del workflow falló durante la ejecución. Revisa los detalles de la ejecución para ver el error específico del node. | | FLK-0505 | Ya existe una ejecución con esta clave de idempotencia. Usa una clave nueva para ejecuciones distintas. | | FLK-0506 | El cuerpo de la solicitud no debe exceder 1 MB. Reduce el tamaño de la carga de entrada. | | FLK-0507 | El disyuntor de esta configuración de provider está abierto tras fallos repetidos. Espera antes de reintentar. | | FLK-0508 | Se detectó un ciclo en el grafo del workflow. Revisa los edges y elimina las referencias circulares. | | FLK-0509 | El encabezado `Idempotency-Key` es obligatorio en las solicitudes de ejecución. Incluye una clave única. | ## 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. | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0322 | El cuerpo de la respuesta del provider excede el límite de tamaño configurado. Reintentar no ayuda: la respuesta no se reducirá. | | FLK-0324 | El cuerpo de solicitud que Flowker enviaría excede el límite de tamaño configurado. La solicitud se rechaza antes de cualquier llamada de red. | | FLK-0937 | Un node HTTP declara `request_format` de tipo `xml_converted` sin un `root_element` válido. Proporciona un nombre de elemento XML sintácticamente válido. | | FLK-0938 | Un node `xml_passthrough` no tiene carga XML del trigger para reenviar. El passthrough reenvía los bytes originales del trigger, así que necesita un trigger XML. | | FLK-0939 | La carga retenida del trigger de un node `xml_passthrough` no admite reenvío byte a byte, por ejemplo una carga que no es UTF-8 válido. | | FLK-0940 | El cuerpo mapeado de un node `xml_converted` no es un objeto estructurado. El XML convertido necesita un objeto para serializar bajo `root_element`. | | FLK-0941 | El cuerpo mapeado no se pudo codificar como XML. Revisa la estructura que producen los mapeos. | ## Errores de concurrencia *** | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------- | | FLK-0350 | El estado del recurso cambió de forma concurrente. Reintenta con la versión más reciente. | ## Errores de webhook *** | Código | Qué significa | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0360 | La ruta de webhook ya está registrada por otro workflow activo. Elige una ruta diferente o desactiva el workflow en conflicto. | | FLK-0361 | No hay ningún webhook registrado para esta ruta y método. Verifica la ruta y el método del webhook e inténtalo de nuevo. | | FLK-0363 | El cuerpo de la solicitud de webhook no debe exceder 1 MB. Reduce el tamaño de la carga. | | FLK-0364 | El cuerpo de la solicitud de webhook no es XML bien formado. Las rutas XML lo devuelven como `XML_MALFORMED` en el envoltorio ``. | ## 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. | Código | Qué significa | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0930 | El `input_contract` del trigger es `xsd`, pero su `xsd_schema_id` no resuelve a un esquema XSD almacenado. | | FLK-0931 | El `input_contract` del trigger es `openapi`, pero su `openapi_schema_id` no resuelve a un esquema OpenAPI almacenado. | | FLK-0932 | El esquema OpenAPI referenciado no declara ninguna operación que coincida con `operation_path` y `operation_method`. | | FLK-0933 | La operación OpenAPI encontrada no declara cuerpo de solicitud JSON, así que no puede validar una carga entrante. | | FLK-0934 | La configuración del trigger de webhook no coincide con el esquema del trigger. El esquema es cerrado, así que el trigger falla cuando omite `path`, `method` o `input_contract`, olvida un campo que su modo `input_contract` requiere, nombra el id de esquema o un campo de operación de otro modo, o lleva una clave o un valor que el esquema no acepta. Revisa este error primero al configurar un trigger de webhook. | | FLK-0935 | La carga entrante es JSON bien formado pero no cumple el esquema de cuerpo de solicitud de la operación. | | FLK-0936 | El esquema OpenAPI no se puede eliminar porque uno o más workflows activos lo referencian desde un trigger de webhook. Las referencias desde workflows en borrador o inactivos no bloquean la eliminación. | ## Errores de esquemas XSD *** | Código | Qué significa | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0700 | El esquema XSD solicitado no existe. Verifica el ID del esquema e inténtalo de nuevo. | | FLK-0701 | Ya existe un esquema XSD con este nombre y versión. Elige un nombre o una versión diferentes. | | FLK-0702 | El contenido cargado no pasó la validación XSD. Verifica el documento del esquema. | | FLK-0703 | El archivo del esquema XSD excede el límite de 1 MiB. Reduce el tamaño del archivo. | | FLK-0704 | El esquema XSD no se puede eliminar porque uno o más nodes de workflow lo referencian. | | FLK-0710 | El campo `name` es obligatorio. Proporciona un nombre para el esquema XSD. | | FLK-0711 | El campo `version` es obligatorio. Proporciona una versión para el esquema XSD. | | FLK-0712 | El contenido del esquema es obligatorio. Carga el documento XSD. | | FLK-0720 | El servicio de validación XML no está accesible o devolvió un fallo, así que la carga no se pudo validar. Flowker rechaza la solicitud en lugar de aceptar XML sin validar. | ## 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. | Código | Qué significa | | -------- | ----------------------------------------------------------------------------------------------------------------------- | | FLK-0807 | El campo `name` es obligatorio. Proporciona un nombre para el esquema OpenAPI. | | FLK-0808 | El campo `version` es obligatorio. Proporciona una versión para el esquema OpenAPI. | | FLK-0809 | El nombre del esquema OpenAPI excede la longitud máxima permitida. Reduce el tamaño del nombre. | | FLK-0810 | La versión del esquema OpenAPI excede la longitud máxima permitida. Reduce el tamaño de la versión. | | FLK-0811 | El esquema OpenAPI solicitado no existe. Verifica el ID del esquema e inténtalo de nuevo. | | FLK-0812 | Ya existe un esquema OpenAPI con este nombre y versión. Elige un nombre o una versión diferentes. | | FLK-0813 | El contenido del esquema es obligatorio. Carga el documento OpenAPI. | | FLK-0900 | Los bytes cargados no se interpretan como un documento OpenAPI 3.x válido, o el documento no declara ninguna operación. | | FLK-0901 | El esquema OpenAPI cargado excede el límite de 8 MiB. Reduce el tamaño del archivo. | | FLK-0902 | El esquema almacenado no declara ninguna operación que coincida con la ruta y el método solicitados. Verifícalos. | ## 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. | Código | Qué significa | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | FLK-0801 | A la solicitud de fijar la versión le falta el servicio o la versión. Proporciona ambos. | | FLK-0802 | Los bytes cargados no se interpretan como un documento OpenAPI 3.x válido. Verifica la especificación. | | FLK-0803 | Ya hay una especificación almacenada para este servicio y versión. Las versiones son inmutables: carga una versión nueva. | | FLK-0804 | El registro de esquemas no tiene almacenamiento configurado, así que la carga no se puede aceptar. | | FLK-0805 | La especificación cargada excede el límite de tamaño del registro. Reduce el tamaño del archivo. | | FLK-0806 | El identificador de servicio o versión en la ruta está malformado. Elimina valores vacíos, barras, `..`, caracteres de control y puntos iniciales. | ## Errores de ocurrencias programadas *** | Código | Qué significa | | -------- | ---------------------------------------------------------------------------------------------------- | | FLK-0755 | La ocurrencia no está en un estado que permita ejecutarla o descartarla. Revisa su estado actual. | | FLK-0760 | La ocurrencia programada solicitada no existe. Verifica el ID de la ocurrencia e inténtalo de nuevo. |