Formato de erro
A API de gestão/v1 retorna erros como um documento de problema RFC 9457, 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.
{
"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. É semprehttps://errors.lerian.studio/v1/mais ocode.title– A frase-padrão de motivo HTTP parastatus, comoNot FoundouConflict. 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 usecodepara 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.
Detalhes de erro por campo
Quando uma requisição falha na validação de campos específicos, o documento de problema carrega um arrayerrors. Cada entrada nomeia a entrada com problema.
{
"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"
}
]
}
{
"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": []
}
]
}
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 typeapplication/json:
{
"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, comoNot FoundouPayload Too Large.message– Uma explicação legível por humanos dessa ocorrência.
<error> em vez disso, porque toda a rota funciona em XML.
<error>
<code>XML_VALIDATION_FAILED</code>
<message>element 'valor' is not a valid decimal</message>
<details>line 12, column 5</details>
<requestId>018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8</requestId>
</error>
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. |

