Documentos
Obtener el PDF
GET/generations/{id}/pdf
El PDF del documento, renderizado una sola vez en nuestros servidores, como una URL de descarga de corta duración. Si aún no hay nada almacenado, la llamada lo renderiza bajo demanda y responde al terminar, normalmente en pocos segundos; si ya hay un renderizado en curso en otro lugar, responde 202 y vuelves a preguntar en breve.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
idobligatorio | uuid | El id del documento. |
download | 1 | Convierte la URL en un adjunto con el nombre del documento. |
redirect | 1 | Responde un 302 a la URL en lugar de JSON. |
Petición
curl "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf?download=1" \
-H "Authorization: Bearer pc_YOUR_TOKEN"Respuesta
JSON
{
"status": "ready",
"url": "https://…/generation-pdfs/…/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b.pdf?token=…",
"pages": 2,
"expires_in": 60
}- La URL deja de funcionar pasados expires_in segundos. Pide una nueva en lugar de guardarla.
- Un renderizado fallido responde 500 con pdf_render_failed; volver a pedirlo lo reintenta.