Documents

Obtenir le PDF

GET/generations/{id}/pdf

Le PDF du document, produit une seule fois sur nos serveurs, sous forme d’URL de téléchargement à courte durée de vie. Si rien n’est encore stocké, l’appel le produit à la demande et répond une fois terminé, généralement en quelques secondes ; si un rendu est déjà en cours ailleurs, il répond 202 et vous redemandez peu après.

Paramètres

Nom	Type	Description
`id`obligatoire	uuid	L’identifiant du document.
`download`	1	Fait de l’URL une pièce jointe nommée d’après le document.
`redirect`	1	Répond un 302 vers l’URL au lieu de JSON.

Requête

curl "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf?download=1" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

Réponse

JSON

{
  "status": "ready",
  "url": "https://…/generation-pdfs/…/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b.pdf?token=…",
  "pages": 2,
  "expires_in": 60
}

L’URL cesse de fonctionner après expires_in secondes. Demandez-en une nouvelle plutôt que de la stocker.
Un rendu qui a échoué répond 500 avec pdf_render_failed ; le redemander relance la tentative.