> ## 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 erros do Flowker
> As APIs do Flowker retornam documentos de problema RFC 9457 com um código de erro estável, para que você diagnostique problemas e os direcione à equipe certa.
### Formato de erro
A API de gestão `/v1` retorna erros como um documento de problema [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457), servido com o content type `application/problem+json`. As rotas de webhook respondem no formato configurado do seu trigger. Veja [Erros em rotas de webhook](#errors-on-webhook-routes).
```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"
}
```
### Definições de campo
* **`code`** – O código de erro estável do Flowker. Baseie sua integração nesse campo.
* **`type`** – Uma URI que identifica o erro. É sempre `https://errors.lerian.studio/v1/` mais o `code`.
* **`title`** – A frase-padrão de motivo HTTP para `status`, como `Not Found` ou `Conflict`. Não muda por código de erro.
* **`status`** – O código de status HTTP, repetido no corpo.
* **`detail`** – Uma explicação legível por humanos dessa ocorrência. Respostas com status 500 ou acima carregam uma mensagem genérica fixa, então use `code` para diferenciá-las.
* **`instance`** – Uma URI que identifica essa ocorrência específica, quando o endpoint fornece uma.
* **`errors`** – Um array opcional de entradas por campo. Veja [Detalhes de erro por campo](#field-level-error-details).
Detalhes de erro por campo
Quando uma requisição falha na validação de campos específicos, o documento de problema carrega um array `errors`. Cada entrada nomeia a entrada com problema.
```json Example 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 Example 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 carrega uma `location` (onde está o problema, como `body.nodes` ou `path.id`), uma `message`, e o `value` com problema quando é seguro reproduzi-lo.
Erros em rotas de webhook
Uma rota de webhook responde no formato configurado do seu trigger.
Uma rota de webhook JSON retorna um objeto de erro compacto com o content type `application/json`:
```json theme={null}
{
"code": "FLK-0361",
"title": "Not Found",
"message": "no webhook registered for this path and method"
}
```
* **`code`** – O código de erro estável do Flowker, obtido nas tabelas abaixo. Baseie sua integração nesse campo.
* **`title`** – A frase-padrão de motivo HTTP para o status da resposta, como `Not Found` ou `Payload Too Large`.
* **`message`** – Uma explicação legível por humanos dessa ocorrência.
Uma rota de webhook XML retorna um documento `` em vez disso, porque toda a rota funciona em XML.
```xml theme={null}
XML_VALIDATION_FAILED
element 'valor' is not a valid decimal
line 12, column 5
018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8
```
O elemento `code` carrega um código do Flowker das tabelas abaixo ou um de dois códigos específicos de XML:
| Código | O que significa |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `XML_MALFORMED` | O corpo da requisição não é um XML bem formado. Retornado com HTTP 400. |
| `XML_VALIDATION_FAILED` | O corpo é um XML bem formado, mas não está em conformidade com o XSD da rota. Retornado com HTTP 422, e `details` carrega a linha e a coluna do primeiro problema encontrado. |
## Erros gerais
***
Esses erros se aplicam a todos os endpoints da API do Flowker.
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------- |
| FLK-0001 | O corpo da requisição é inválido ou malformado. Verifique o formato JSON e tente novamente. |
| FLK-0002 | O ID fornecido não é um UUID válido. Verifique o ID e tente novamente. |
| FLK-0003 | É necessário autenticar para acessar esse recurso. Envie um bearer token válido. |
| FLK-0004 | Você não tem permissão para realizar essa ação. Verifique as permissões concedidas ao seu token. |
| FLK-9999 | Ocorreu um erro inesperado. Tente novamente mais tarde, ou contate o suporte se o problema persistir. |
## Erros de validação de requisição
***
A API retorna esses erros quando a requisição não atende aos requisitos de validação.
| Código | O que significa |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0300 | A requisição contém campos inesperados. Remova os campos extras e tente novamente. |
| FLK-0301 | Um ou mais campos obrigatórios estão ausentes. Forneça todos os campos obrigatórios e tente novamente. |
| FLK-0302 | A requisição é inválida. Verifique o formato da requisição e tente novamente. |
| FLK-0303 | Um campo usado em um cálculo tem um tipo inválido. Verifique os tipos dos campos e tente novamente. |
| FLK-0304 | Um ou mais parâmetros de query são inválidos. Verifique os parâmetros e tente novamente. |
| FLK-0305 | A data deve estar no formato RFC 3339 com fuso horário, como `2026-01-28T10:30:00Z`. Valores apenas com data são rejeitados. |
| FLK-0306 | A data final deve ser posterior à data inicial. Forneça um intervalo de datas válido. |
| FLK-0307 | O intervalo de datas solicitado excede o período máximo permitido. Reduza o intervalo de datas. |
| FLK-0308 | O intervalo de datas é inválido. Verifique as datas inicial e final. |
| FLK-0309 | O parâmetro `limit` excede o valor máximo permitido. Reduza o limite e tente novamente. |
| FLK-0310 | A ordem de classificação deve ser `ASC` ou `DESC`. Forneça um valor válido. |
| FLK-0311 | O parâmetro de path fornecido é inválido. Verifique o valor do parâmetro e tente novamente. |
| FLK-0312 | A chave de metadados excede o tamanho máximo permitido de 64 caracteres. Reduza o tamanho da chave. |
| FLK-0313 | O valor de metadados excede o tamanho máximo permitido. Reduza o tamanho do valor. |
| FLK-0314 | Valores de metadados não podem ser objetos aninhados. Forneça pares chave-valor simples. |
| FLK-0315 | Os metadados excedem o número máximo de entradas. Reduza o número de entradas de metadados. |
| FLK-0321 | O cursor de paginação está malformado ou não pôde ser decodificado. Solicite a primeira página novamente e siga o cursor retornado pela API. |
## Erros de entidade
***
| Código | O que significa |
| -------- | ------------------------------------------------------------------------------------------- |
| FLK-0400 | A entidade solicitada não existe. Verifique o ID e tente novamente. |
| FLK-0401 | Essa ação não é permitida no estado atual. Verifique o status do recurso e tente novamente. |
| FLK-0402 | A entidade pai referenciada não existe. Verifique o ID do pai e tente novamente. |
## Erros de workflow
***
| Código | O que significa |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0100 | O workflow solicitado não existe. Verifique o ID do workflow e tente novamente. |
| FLK-0101 | Já existe um workflow com esse nome. Escolha um nome diferente e tente novamente. |
| FLK-0102 | A transição de status solicitada não é permitida. Verifique o status atual do workflow e as transições válidas. |
| FLK-0103 | Workflows que não estão em rascunho não podem ser modificados. Crie uma nova versão, ou reverta o workflow para rascunho. |
| FLK-0104 | Um nó referencia um executor de catálogo que não existe. Verifique o `executorId` no nó. |
| FLK-0105 | A expressão condicional é inválida ou não pôde ser avaliada. Verifique a sintaxe da expressão. |
| FLK-0110 | O campo `name` é obrigatório. Forneça um nome para o workflow e tente novamente. |
| FLK-0111 | O nome do workflow excede o tamanho máximo permitido. Reduza o tamanho do nome. |
| FLK-0112 | Um workflow deve ter pelo menos um nó. Adicione nós ao workflow e tente novamente. |
| FLK-0113 | O workflow excede o número máximo de nós permitido. Reduza o número de nós. |
| FLK-0114 | O workflow excede o número máximo de arestas permitido. Reduza o número de arestas. |
| FLK-0115 | Uma aresta referencia um nó que não existe no workflow. Verifique todos os valores de origem e destino das arestas. |
| FLK-0116 | O workflow deve ter pelo menos um nó de trigger. Adicione um trigger e tente novamente. |
| FLK-0117 | O trigger de agendamento carrega uma expressão cron inválida. Use um cron padrão de 5 campos. Agendamentos com granularidade abaixo de um minuto não são suportados. |
| FLK-0118 | O workflow não tem trigger de agendamento, então não tem próximas ocorrências para listar ou gerenciar. |
| FLK-0120 | Cada nó deve ter um ID. Forneça um ID para todos os nós. |
| FLK-0121 | Cada nó deve ter um tipo. Forneça um tipo para todos os nós. |
| FLK-0122 | O override `responseStatusCode` de `set_output` de um nó de ação deve ser um número inteiro entre 200 e 599. Corrija o valor e tente novamente. |
| FLK-0130 | Cada aresta deve ter um ID. Forneça um ID para todas as arestas. |
| FLK-0131 | Cada aresta deve especificar um nó de origem. Forneça o ID do nó de origem. |
| FLK-0132 | Cada aresta deve especificar um nó de destino. Forneça o ID do nó de destino. |
| FLK-0140 | A configuração de mapeamento de entrada é inválida. Verifique a sintaxe do mapeamento e as referências de campo. |
| FLK-0141 | A configuração de mapeamento de saída é inválida. Verifique a sintaxe do mapeamento e as referências de campo. |
| FLK-0142 | A configuração de transformação é inválida. Verifique as expressões de transformação. |
| FLK-0143 | O template `data.body` de um nó não pôde ser resolvido contra o contexto do workflow, porque uma referência `${...}` está malformada ou não se resolve. O nó falha sem chamar o serviço externo. |
| FLK-0150 | O `providerConfigId` do nó está ausente, não é um UUID válido, ou nomeia uma configuração de provedor que não existe ou não está ativa. Verifique o `providerConfigId` em todo nó de executor, e a existência e o status da configuração que ele nomeia. |
| FLK-0151 | Um nó combina uma configuração de provedor de um provedor com um executor de outro. Verifique se o `providerId` da configuração e o `executorId` do nó nomeiam o mesmo provedor de catálogo. |
## Erros de condição de workflow
***
A API retorna esses erros quando o objeto `condition` estruturado de um nó falha na validação durante a criação ou atualização do workflow.
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0160 | O campo `version` da condição está ausente ou não é `2`. |
| FLK-0161 | O objeto de condição está estruturalmente malformado, como um valor de `cases` que não é um array. |
| FLK-0162 | A condição não tem cases. Adicione pelo menos um case. |
| FLK-0163 | Dois cases, ou um case e o branch padrão, compartilham o mesmo ID de handle de saída. Dê a cada branch um handle único. |
| FLK-0164 | Um case tem um ID de handle de saída vazio. Forneça um handle para cada case. |
| FLK-0165 | O `mode` da condição deve ser `rules` ou `value`. |
| FLK-0166 | Uma condição no modo `value` precisa de um operando de assunto. Forneça o assunto. |
| FLK-0167 | O `combinator` de um grupo deve ser `and` ou `or`. |
| FLK-0168 | Um grupo não carrega regras nem grupos aninhados. Adicione pelo menos uma regra, ou remova o grupo. |
| FLK-0169 | O operador da regra não é reconhecido. Use um operador da taxonomia suportada. |
| FLK-0170 | O `valueType` da regra não é reconhecido. Use um tipo de valor da taxonomia suportada. |
| FLK-0171 | O operador não é permitido para o `valueType` selecionado. Altere o operador ou o tipo de valor. |
| FLK-0172 | Um operando tem um caminho `source` vazio. Forneça o caminho a ser lido. |
| FLK-0173 | Uma transformação tem uma operação inválida, ou parâmetros inválidos para sua operação. |
| FLK-0174 | O `kind` de um operando à direita deve ser `literal` ou `source`, e um operando `source` à direita precisa de um caminho de origem. |
| FLK-0175 | O branch padrão tem um ID de handle de saída vazio. Forneça um handle. |
| FLK-0176 | A condição excede o número máximo de cases. Reduza o número de cases. |
| FLK-0177 | Um grupo excede o número máximo de regras. Divida as regras entre grupos aninhados. |
| FLK-0178 | O pipeline de transformação de um operando excede o número máximo de transformações. Reduza o pipeline. |
| FLK-0179 | Uma regra `matchesRegex` ou `notMatchesRegex` carrega uma expressão regular que excede o tamanho máximo. |
| FLK-0180 | Uma regra `isIn` ou `notIn` carrega uma lista que excede o número máximo de itens. |
| FLK-0181 | A condição é estruturalmente válida, mas não pôde ser compilada. Revise os operandos e literais no nó reportado. |
| FLK-0182 | A árvore de condições é grande demais no conjunto de seus cases. Reduza o número de grupos e regras. |
## Erros de catálogo, executor e trigger
***
| Código | O que significa |
| -------- | --------------------------------------------------------------------------------------------------------------- |
| FLK-0200 | O executor solicitado não existe no catálogo. Verifique o ID do executor e tente novamente. |
| FLK-0201 | A configuração de um nó não corresponde ao JSON Schema do executor de catálogo. Verifique-a contra esse schema. |
| FLK-0210 | O trigger solicitado não existe no catálogo. Verifique o ID do trigger e tente novamente. |
| FLK-0211 | A configuração do trigger é inválida. Verifique o formato da configuração. |
| FLK-0220 | O runner solicitado não existe. Verifique o ID do runner e tente novamente. |
| FLK-0230 | O provedor solicitado não existe no catálogo. Verifique o ID do provedor e tente novamente. |
| FLK-0231 | Já existe um provedor com esse identificador. Use o provedor existente, ou escolha um ID diferente. |
| FLK-0232 | A configuração do provedor é inválida. Verifique o formato da configuração. |
| FLK-0240 | O template solicitado não existe no catálogo. Verifique o ID do template e tente novamente. |
| FLK-0242 | Um ou mais parâmetros do template são inválidos. Verifique os parâmetros contra o schema do template. |
## Erros de configuração de executor
***
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0250 | A configuração de executor solicitada não existe. Verifique o ID e tente novamente. |
| FLK-0251 | Já existe uma configuração de executor com esse nome. Escolha um nome diferente e tente novamente. |
| FLK-0252 | A configuração de executor não pode ser modificada em seu status atual. Verifique o status e tente novamente. |
| FLK-0260 | O campo `name` é obrigatório. Forneça um nome para a configuração de executor. |
| FLK-0261 | O nome da configuração de executor excede o tamanho máximo permitido. Reduza o tamanho do nome. |
| FLK-0262 | O campo `baseUrl` é obrigatório. Forneça uma URL base para a configuração de executor. |
| FLK-0263 | A URL base fornecida não é uma URL válida. Verifique o formato da URL. |
| FLK-0264 | A URL base excede o tamanho máximo permitido. Reduza o tamanho da URL. |
| FLK-0265 | Pelo menos um endpoint deve estar configurado. Forneça definições de endpoint. |
| FLK-0266 | A configuração de autenticação é obrigatória. Forneça as configurações de auth. |
| FLK-0267 | A descrição excede o tamanho máximo permitido. Reduza o tamanho da descrição. |
| FLK-0268 | O campo de tipo de auth é obrigatório. Forneça um tipo de autenticação. |
| FLK-0269 | O tipo de auth não é reconhecido. Forneça um tipo de autenticação válido. |
| FLK-0270 | Cada endpoint deve ter um nome. Forneça nomes para todos os endpoints. |
| FLK-0271 | Cada endpoint deve ter um path. Forneça paths para todos os endpoints. |
| FLK-0272 | Cada endpoint deve especificar um método HTTP. Forneça métodos para todos os endpoints. |
| FLK-0273 | O método HTTP de um endpoint não é reconhecido. Verifique o método em cada endpoint e tente novamente. |
| FLK-0284 | A URL base resolve para um endereço que o Flowker recusa chamar, como um host loopback ou link-local. Use um host externo roteável. |
| FLK-0285 | O host da URL base não é permitido pela lista de hosts permitidos da configuração. Adicione o host à lista, ou altere a URL. |
## Erros de configuração de provedor
***
| Código | O que significa |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0290 | A configuração de provedor solicitada não existe. Verifique o ID e tente novamente. |
| FLK-0291 | Já existe uma configuração de provedor com esse nome. Escolha um nome diferente e tente novamente. |
| FLK-0292 | A configuração de provedor não pode ser modificada em seu status atual. Verifique o status e tente novamente. |
| FLK-0293 | O objeto `config` não corresponde ao schema obrigatório do provedor, ou uma entrada de `schemaBindings` está malformada — um `type` desconhecido, um `schemaId` vazio, que não é um UUID, ou que é todo zeros, `operations` em um binding que não é `openapi`, ou uma operação cujo path ou método HTTP está ausente ou é inválido. Verifique os campos da configuração e cada schema binding. |
| FLK-0294 | O provedor referenciado não existe no catálogo. Verifique o ID do provedor. |
| FLK-0295 | O campo `name` é obrigatório. Forneça um nome para a configuração de provedor. |
| FLK-0296 | O nome da configuração de provedor excede o tamanho máximo permitido. Reduza o tamanho do nome. |
| FLK-0297 | O campo `providerId` é obrigatório para uma configuração de provedor `catalog`. Forneça um ID de provedor. |
| FLK-0298 | O campo `config` é obrigatório. Forneça o objeto de configuração do provedor. |
| FLK-0299 | A descrição excede o tamanho máximo permitido. Reduza o tamanho da descrição. |
| FLK-0316 | O ID da configuração de provedor é obrigatório para essa operação. Forneça o ID. |
| FLK-0317 | Uma entrada na lista de hosts permitidos não é um host válido. Verifique cada entrada. |
| FLK-0320 | Uma URL base na configuração aponta para um host que a própria lista de hosts permitidos rejeita. Alinhe a URL e a lista. |
| FLK-0323 | Uma configuração para o provedor HTTP genérico deve declarar uma lista de hosts permitidos. Uma lista vazia permitiria chamadas para qualquer endereço, então é rejeitada. |
| FLK-0952 | A atualização mudou o tipo de auth sem fornecer uma credencial que o novo tipo exige e o anterior não exigia. Envie esse valor junto com a mudança de tipo. |
| FLK-0953 | A requisição enviou um placeholder de credencial mascarada. Omita o campo para manter a credencial armazenada, ou envie seu valor real para substituí-la. |
## Erros de configuração de provedor OpenAPI externo
***
Esses erros se aplicam a configurações de provedor do tipo `external_openapi`, que chamam uma operação declarada por um schema OpenAPI armazenado.
| Código | O que significa |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0946 | A configuração omite a referência obrigatória `config.openapi_schema_id`. Forneça o ID do schema. |
| FLK-0947 | O schema OpenAPI referenciado não existe no seu tenant. Verifique o ID do schema. |
| FLK-0948 | O bloco `config.auth` está malformado — um tipo desconhecido, um campo obrigatório ausente, ou o formato errado. |
| FLK-0949 | Nem `config.base_url` nem uma entrada `servers` utilizável no schema referenciado resolvem uma URL base. O nó falha sem chamar o serviço. |
| FLK-0950 | A operação vinculada está ausente do schema referenciado, ou o schema armazenado não é mais interpretável. O nó falha sem chamar o serviço. |
| FLK-0951 | O esquema de assinatura de requisição HMAC não conseguiu resolver seu segredo. A requisição nunca é enviada sem assinatura. |
## Erros de vínculo de schema de provedor
***
| Código | O que significa |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| FLK-0942 | Um vínculo de schema referencia um ID de schema XSD ou OpenAPI que não existe no seu tenant. Verifique o ID do schema. |
| FLK-0943 | Um vínculo de schema OpenAPI restringe a uma operação que o documento referenciado não declara. Verifique o path e o método. |
| FLK-0944 | A configuração lista o mesmo vínculo duas vezes. Remova a duplicata. |
| FLK-0945 | O schema não pode ser excluído porque pelo menos uma configuração de provedor ativa o vincula. A resposta lista as configurações de provedor e os workflows que o referenciam. |
## Erros de execução de workflow
***
| Código | O que significa |
| -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0500 | A execução solicitada não existe. Verifique o ID da execução e tente novamente. |
| FLK-0501 | O workflow não está em estado ativo e não pode ser executado. Ative o workflow e tente novamente. |
| FLK-0502 | Uma execução anterior desse workflow ainda está em andamento. Aguarde sua conclusão. |
| FLK-0503 | A execução do workflow expirou antes de concluir. Verifique a lógica do workflow e os tempos de resposta dos serviços externos. |
| FLK-0504 | Um nó dentro do workflow falhou durante a execução. Verifique os detalhes da execução para o erro específico do nó. |
| FLK-0505 | Já existe uma execução com essa chave de idempotência. Use uma nova chave para execuções distintas. |
| FLK-0506 | O corpo da requisição não pode exceder 1 MB. Reduza o tamanho do payload de entrada. |
| FLK-0507 | O circuit breaker dessa configuração de provedor está aberto após falhas repetidas. Aguarde antes de tentar novamente. |
| FLK-0508 | Foi detectado um ciclo no grafo do workflow. Revise as arestas e remova as referências circulares. |
| FLK-0509 | O header `Idempotency-Key` é obrigatório para requisições de execução. Inclua uma chave única no header. |
## Erros de requisição de saída
***
Esses erros ocorrem enquanto um nó chama um serviço externo. Eles aparecem como falhas de nó nos detalhes da execução.
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0322 | O corpo de resposta do provedor excede o limite de tamanho configurado. Tentar novamente não ajuda — a resposta não vai encolher. |
| FLK-0324 | O corpo da requisição que o Flowker enviaria excede o limite de tamanho configurado. A requisição é rejeitada antes de qualquer chamada de rede. |
| FLK-0937 | Um nó HTTP declara `request_format` do tipo `xml_converted` sem um `root_element` válido. Forneça um nome de elemento XML sintaticamente válido. |
| FLK-0938 | Um nó `xml_passthrough` não tem payload de trigger XML para encaminhar. O passthrough encaminha os bytes originais do trigger, então precisa de um trigger XML. |
| FLK-0939 | O payload de trigger retido de um nó `xml_passthrough` não é elegível para encaminhamento byte a byte, como um payload que não é UTF-8 válido. |
| FLK-0940 | O corpo mapeado de um nó `xml_converted` não é um objeto estruturado. XML convertido precisa de um objeto para serializar sob `root_element`. |
| FLK-0941 | O corpo mapeado não pôde ser codificado como XML. Revise a estrutura que os mapeamentos produzem. |
| FLK-0958 | O `content_digest` de um nó está malformado ou não se resolve a um digest não vazio. Forneça um valor SHA-256 hexadecimal de 64 caracteres. |
| FLK-0959 | O corpo da requisição montado não corresponde ao `content_digest`, ou nenhum corpo foi montado. O Flowker rejeita a requisição antes de qualquer chamada de rede. |
## Erros de concorrência
***
| Código | O que significa |
| -------- | -------------------------------------------------------------------------------------- |
| FLK-0350 | O estado do recurso mudou concorrentemente. Tente novamente com a versão mais recente. |
## Erros de webhook
***
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| FLK-0360 | O path do webhook já está registrado por outro workflow ativo. Escolha um path diferente, ou desative o workflow em conflito. |
| FLK-0361 | Nenhum webhook está registrado para esse path e método. Verifique o path e o método do webhook, e tente novamente. |
| FLK-0363 | O corpo da requisição do webhook não pode exceder 1 MB. Reduza o tamanho do payload. |
## Erros de contrato de trigger de webhook
***
A API retorna esses erros quando você salva o `input_contract` de um trigger de webhook ou ativa o workflow. Ela também os retorna durante a validação de um payload recebido contra o contrato.
| Código | O que significa |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0930 | O `input_contract` do trigger é `xsd`, mas seu `xsd_schema_id` não se resolve a um schema XSD armazenado. |
| FLK-0931 | O `input_contract` do trigger é `openapi`, mas seu `openapi_schema_id` não se resolve a um schema OpenAPI armazenado. |
| FLK-0932 | O schema OpenAPI referenciado não declara nenhuma operação que corresponda ao `operation_path` e `operation_method` do trigger. |
| FLK-0933 | A operação OpenAPI correspondente não declara nenhum corpo de requisição JSON, então não pode validar um payload recebido. |
| FLK-0934 | A configuração do trigger de webhook não corresponde ao schema do trigger. O schema é fechado, então o trigger falha quando omite `path` ou `method`, deixa de fornecer um campo que o modo `input_contract` selecionado exige, nomeia o id de schema ou campo de operação de outro modo, ou carrega uma chave ou um valor que o schema não aceita. Verifique esse erro primeiro ao configurar um trigger de webhook. |
| FLK-0935 | O payload recebido é um JSON bem formado, mas não está em conformidade com o schema do corpo de requisição da operação. |
| FLK-0936 | O schema OpenAPI não pode ser excluído porque um ou mais workflows ativos o referenciam a partir de um trigger de webhook. Referências de workflows em rascunho ou inativos não bloqueiam a exclusão. |
| FLK-0957 | A declaração opcional `accepted_headers` do trigger é inválida. Use uma lista de nomes de header válidos, não vazios e não duplicados; nomes que carregam credenciais são recusados. |
## Erros de requisição e configuração de OpenAPI externo
***
| Código | O que significa |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0954 | Um parâmetro `header` ou `query` obrigatório para uma operação OpenAPI externa não encontrou nenhum valor. O nó falha antes de o Flowker enviar uma requisição. |
| FLK-0955 | Uma configuração de provedor `external_openapi` tem um bloco `config.headers` malformado. Use nomes de header válidos, não vazios e únicos sem diferenciar maiúsculas de minúsculas, com valores string. |
## Erros de schema XSD
***
| Código | O que significa |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FLK-0700 | O schema XSD solicitado não existe. Verifique o ID do schema e tente novamente. |
| FLK-0701 | Já existe um schema XSD com esse nome e versão. Escolha um nome ou versão diferente. |
| FLK-0702 | O conteúdo enviado falhou na validação XSD. Verifique o documento de schema. |
| FLK-0703 | O arquivo de schema XSD excede o limite de 1 MiB. Reduza o tamanho do arquivo. |
| FLK-0704 | O schema XSD não pode ser excluído porque um ou mais nós de workflow o referenciam. |
| FLK-0710 | O campo `name` é obrigatório. Forneça um nome para o schema XSD. |
| FLK-0711 | O campo `version` é obrigatório. Forneça uma versão para o schema XSD. |
| FLK-0712 | O conteúdo do schema é obrigatório. Faça upload do documento XSD. |
| FLK-0720 | O serviço de validação XML está inacessível ou retornou uma falha, então o payload não pôde ser validado. O Flowker rejeita a requisição em vez de aceitar XML não validado. |
## Erros de schema OpenAPI externo
***
Esses erros se aplicam aos schemas OpenAPI que você armazena por tenant e referencia a partir de triggers, configurações de provedor e nós.
| Código | O que significa |
| -------- | --------------------------------------------------------------------------------------------------------------------------- |
| FLK-0807 | O campo `name` é obrigatório. Forneça um nome para o schema OpenAPI. |
| FLK-0808 | O campo `version` é obrigatório. Forneça uma versão para o schema OpenAPI. |
| FLK-0809 | O nome do schema OpenAPI excede o tamanho máximo permitido. Reduza o tamanho do nome. |
| FLK-0810 | A versão do schema OpenAPI excede o tamanho máximo permitido. Reduza o tamanho da versão. |
| FLK-0811 | O schema OpenAPI solicitado não existe. Verifique o ID do schema e tente novamente. |
| FLK-0812 | Já existe um schema OpenAPI com esse nome e versão. Escolha um nome ou versão diferente. |
| FLK-0813 | O conteúdo do schema é obrigatório. Faça upload do documento OpenAPI. |
| FLK-0900 | Os bytes enviados não são interpretáveis como um documento OpenAPI 3.x válido, ou o documento não declara nenhuma operação. |
| FLK-0901 | O schema OpenAPI enviado excede o limite de 8 MiB. Reduza o tamanho do arquivo. |
| FLK-0902 | O schema armazenado não declara nenhuma operação que corresponda ao path e método solicitados. Verifique o path e o método. |
## Erros de registro de spec OpenAPI
***
Esses erros se aplicam ao registro compartilhado de specs OpenAPI, que fixa a versão da spec que o Flowker usa para enriquecer os schemas de saída de um serviço.
| Código | O que significa |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| FLK-0801 | A requisição de fixação de versão está sem o serviço ou a versão. Forneça ambos. |
| FLK-0802 | Os bytes enviados não são interpretáveis como um documento OpenAPI 3.x válido. Verifique a spec. |
| FLK-0803 | Já existe uma spec armazenada para esse serviço e versão. Versões são imutáveis — envie uma nova versão. |
| FLK-0804 | O registro de schema não tem armazenamento configurado, então o upload não pode ser aceito. |
| FLK-0805 | A spec enviada excede o limite de tamanho do registro. Reduza o tamanho do arquivo. |
| FLK-0806 | O identificador de path do serviço ou da versão está malformado. Remova valores vazios, barras, `..`, caracteres de controle e pontos no início. |
## Erros de ocorrência agendada
***
| Código | O que significa |
| -------- | ----------------------------------------------------------------------------------------------------- |
| FLK-0755 | A ocorrência não está em um estado que possa ser executado ou descartado. Verifique seu estado atual. |
| FLK-0760 | A ocorrência agendada solicitada não existe. Verifique o ID da ocorrência e tente novamente. |