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.
| Cabecera | Se aplica a | Descripción |
|---|---|---|
X-HTTP-Method-Override | PUT | Procesa 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,PatchyPATCHfuncionan). Cualquier otro valor se ignora y la solicitud sigue siendoPUT. - 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
PATCHreal 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.