Pular para o conteúdo principal

Cabeçalhos de requisição personalizados

Além dos cabeçalhos padrão (Authorization, Content-Type etc.), a API do Sheet Best reconhece alguns cabeçalhos personalizados que permitem alterar o comportamento da requisição.

CabeçalhoAplica-se aDescrição
X-HTTP-Method-OverridePUTProcessa uma requisição PUT como PATCH para não esvaziar as colunas não especificadas.

X-HTTP-Method-Override​

Use este cabeçalho quando seu cliente HTTP não puder enviar uma requisição PATCH, por exemplo, bibliotecas HTTP antigas, determinadas plataformas sem código, sistemas embarcados ou ferramentas de webhook que só aceitam PUT.

Envie a requisição como PUT e adicione:

X-HTTP-Method-Override: PATCH

O Sheet Best tratará a requisição como PATCH, então as colunas omitidas no corpo manterão seus valores em vez de ficarem vazias (como aconteceria com um PUT comum).

Exemplo​

curl 'https://api.sheetbest.com/sheets/<api-id>/1' \
  -X PUT \
  -H 'Content-Type: application/json' \
  -H 'X-HTTP-Method-Override: PATCH' \
  -d '{"Name": "Jack Doe"}'

Regras​

  • O cabeçalho só se aplica a requisições PUT. Ele é ignorado silenciosamente em qualquer outro método (GET, POST, PATCH, DELETE).
  • O único valor aceito é PATCH (sem diferenciar maiúsculas e minúsculas: patch, Patch e PATCH funcionam). Qualquer outro valor é ignorado e a requisição continua sendo PUT.
  • A política CORS do Sheet Best permite esse cabeçalho, então clientes de navegador podem enviá-lo entre origens.
  • Prefira enviar um PATCH real quando seu cliente permitir. Esse cabeçalho é uma solução de compatibilidade, não o caminho recomendado.

Consulte atualizar linhas (PUT / PATCH) para entender a diferença entre PUT e PATCH.