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

<Badge stroke icon="calendar-days" iconType="regular">21 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção de documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

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

***

<Steps>
  <Step>Revise os `accepted_headers` do webhook e o uso downstream de `_webhook.headers`.</Step>
  <Step>Confirme os headers estáticos e cada header e parâmetro de query string obrigatório das integrações OpenAPI externas.</Step>
  <Step>Trate os resultados de validação documentados antes do próximo deploy de workflow.</Step>
</Steps>

### Prazo

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

## Recursos

***

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