문서

PDF 가져오기

GET/generations/{id}/pdf

저희 서버에서 한 번 렌더링된 문서의 PDF를 짧은 유효 기간의 다운로드 URL로 돌려줍니다. 아직 저장된 것이 없으면 이 호출이 필요할 때 렌더링하고 완료되면 응답하며 보통 몇 초가 걸립니다. 다른 곳에서 이미 렌더링 중이면 202를 돌려주니 잠시 후 다시 요청하세요.

매개변수

이름	유형	설명
`id`필수	uuid	문서의 ID.
`download`	1	URL을 문서 이름을 가진 첨부 파일로 만듭니다.
`redirect`	1	JSON 대신 URL로 가는 302를 돌려줍니다.

요청

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

응답

JSON

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

URL은 expires_in초 후에 만료됩니다. 저장하지 말고 새로 요청하세요.
렌더링이 실패하면 500과 pdf_render_failed를 돌려주며, 다시 요청하면 재시도합니다.