Saltar al contenido principal

Cabeceras de solicitud personalizadas

Además de las cabeceras estándar (Authorization, Content-Type, etc.), la API de Sheet Best reconoce algunas cabeceras personalizadas que permiten modificar el comportamiento de la solicitud.

CabeceraSe aplica aDescripción
X-HTTP-Method-OverridePUTProcesa una solicitud PUT como PATCH para no vaciar las columnas no especificadas.

X-HTTP-Method-Override

Usa esta cabecera cuando tu cliente HTTP no pueda enviar una solicitud PATCH, por ejemplo, bibliotecas HTTP antiguas, determinadas plataformas sin código, sistemas integrados o herramientas de webhooks que solo admiten PUT.

Envía la solicitud como PUT y añade:

X-HTTP-Method-Override: PATCH

Sheet Best tratará la solicitud como PATCH, por lo que las columnas omitidas en el cuerpo conservarán sus valores en lugar de quedar vacías (como ocurriría con un PUT normal).

Ejemplo

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"}'

Reglas

  • La cabecera solo se aplica a solicitudes PUT. Se ignora sin aviso en cualquier otro método (GET, POST, PATCH, DELETE).
  • El único valor aceptado es PATCH (sin distinguir mayúsculas y minúsculas: patch, Patch y PATCH funcionan). Cualquier otro valor se ignora y la solicitud sigue siendo PUT.
  • La política CORS de Sheet Best permite esta cabecera, por lo que los clientes de navegador pueden enviarla entre orígenes.
  • Envía un PATCH real cuando tu cliente lo admita. Esta cabecera es una solución de compatibilidad, no la vía recomendada.

Consulta actualizar filas (PUT / PATCH) para conocer la diferencia entre PUT y PATCH.