> ## 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.

# Contrato de headers de webhook e de API externa do Flowker

> A documentação do Flowker agora esclarece os headers aceitos em webhooks e os requisitos de falha fechada da API externa.

21 de agosto de 2026Correção de documentaçãoAção necessária

## Afeta

***

Equipes que configuram gatilhos de webhook do Flowker ou integrações OpenAPI externas.

## O que mudou

***

Os gatilhos de webhook podem declarar `accepted_headers`; os headers de credencial continuam excluídos dessa configuração imutável. A documentação também esclarece as regras de ingestão de headers expostas por `_webhook.headers`.

As integrações OpenAPI externas aceitam `config.headers` estáticos e falham fechadas quando headers ou parâmetros de query string obrigatórios estão ausentes. Os resultados de validação documentados são `FLK-0954` para entradas obrigatórias ausentes, `FLK-0955` para headers estáticos malformados e `FLK-0957` para headers de webhook aceitos inválidos.

Esta é uma correção de documentação de contratos implementados. Não anuncia um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Uma configuração de webhook ou de API externa baseada nas regras anteriores pode falhar na validação ou omitir entradas obrigatórias da requisição.

## O que você precisa fazer

***

**Step 1**

Revise os `accepted_headers` do webhook e o uso downstream de `_webhook.headers`.

**Step 2**

Confirme os headers estáticos e cada header e parâmetro de query string obrigatório das integrações OpenAPI externas.

**Step 3**

Trate os resultados de validação documentados antes do próximo deploy de workflow.

### Prazo

Conclua a revisão antes do próximo deploy de workflow afetado.

## Recursos

***

* [Configurar um gatilho de webhook](https://docs.lerian.studio/pt/products/flowker/configuring-a-webhook-trigger.md)
* [Conectar a sua própria API](https://docs.lerian.studio/pt/products/flowker/connecting-your-own-api.md)
* [Lista de erros do Flowker](https://docs.lerian.studio/pt/reference/products/flowker/flowker-error-list.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.