3 min de lectura

GET o POST para ejecuciones de API de capturas

Usa GET para ejecuciones rápidas por URL y POST para solicitudes de API de capturas con cabeceras, cookies, pasos, etiquetas o almacenamiento.

API de capturasAPI de renderizado
En esta página

Úsalo cuando

  • Usa GET para una URL rápida a captura, PDF, HTML o Markdown.
  • Usa POST para cookies, cabeceras, pasos, salida a archivo, almacenamiento o cargas más largas.
  • Si un valor sensible debe viajar por una URL, usa una clave de API estrecha y de corta duración.
GET o POST para ejecuciones de API de capturas

Cuándo basta GET y cuándo conviene POST

Una API de capturas suele empezar con una URL sencilla. Ahí GET sigue siendo útil: envías la página, el formato de salida, el tamaño de vista y la caché, y recibes el resultado.

POST encaja cuando la ejecución entra en trabajo real. Cabeceras, cookies, HTML de entrada, Markdown de salida, etiquetas, almacenamiento y pasos se leen mejor en el cuerpo de la solicitud. Los valores sensibles no quedan en el historial del navegador, registros del servidor ni URL compartidas.

Dónde encaja en flujos reales

GET sirve para un resultado rápido. POST encaja cuando la misma página debe revisarse de nuevo, etiquetarse, enviarse a almacenamiento o conectarse con una publicación.

RenderLog mantiene ambos estilos en el mismo historial. Un desarrollador puede empezar con una llamada de API y luego el equipo puede llevar el mismo objetivo a revisión manual, suites de revisión, referencias y avisos.

  • Los trabajos de CI pueden mantener legibles las llamadas cortas.
  • Los servicios de servidor pueden enviar solicitudes estructuradas sin codificar cada opción en la URL.
  • El equipo conserva archivos de resultado, registros, etiquetas e historial de revisión cuando termina la llamada.

Elegir la primera forma de solicitud

Empieza con GET si pruebas RenderLog desde una terminal o un navegador. Pasa a POST antes de añadir cookies, cabeceras de autorización, almacenamiento propio o un flujo con esperas y selectores. Si la página necesita revisiones repetidas, guarda la configuración como suite de revisión.

Así el primer experimento sigue siendo pequeño sin encerrar al equipo en una API de renderizado básica. El mismo objetivo puede convertirse después en una comprobación visual programada con etiquetas, referencias y avisos.

Enlaces relacionados

Preguntas frecuentes

¿Empiezo con GET o con POST?
Empieza con GET para una prueba rápida. Pasa a POST antes de añadir cookies, cabeceras, almacenamiento o flujos de varios pasos.
¿POST cambia el flujo de revisión?
No. Las ejecuciones GET y POST llegan al mismo historial de RenderLog con archivos de resultado, etiquetas y contexto de revisión.