Caché y ETag

Cómo usarlo

Guarda el ETag

En la primera respuesta, lee el header ETag.

Reenvía con If-None-Match

En la siguiente petición idéntica, manda If-None-Match: <etag>.

Recibe 304

Si nada cambió, la API responde 304 Not Modified sin cuerpo. Reusas tu copia local.

Ejemplo

# Primera vez: guarda el ETag
ETAG=$(curl -sD - -o salida.md \
  -X POST "https://api.markpdf.tech/convert/raw?filename=informe.pdf" \
  -H "x-api-key: TU_API_KEY" \
  -H "content-type: application/pdf" \
  --data-binary "@informe.pdf" | grep -i '^etag:' | cut -d' ' -f2 | tr -d '\r')

# Segunda vez: si no cambió, responde 304
curl -i -X POST "https://api.markpdf.tech/convert/raw?filename=informe.pdf" \
  -H "x-api-key: TU_API_KEY" \
  -H "content-type: application/pdf" \
  -H "If-None-Match: $ETAG" \
  --data-binary "@informe.pdf"

Cache-Control

La respuesta marca Cache-Control: public, max-age=..., immutable. El ETag cambia si cambia el documento o cualquier parámetro, así que es seguro cachear de forma agresiva.

El ETag cambia con los parámetros. Convertir el mismo PDF en fast y en balanced produce ETags distintos.

Empezar

Conceptos

Caché y ETag

Caché y ETag

Cómo usarlo

Ejemplo

Cache-Control

​Caché y ETag

​Cómo usarlo

​Ejemplo

​Cache-Control

Caché y ETag

Cómo usarlo

Ejemplo

Cache-Control