API 요청
/rest/document_download요청 파라미터 4개 · 필수 4
document_id- 예시
입력값
version- 예시
1
content_hash- 예시
입력값
request_id- 예시
입력값
응답 필드 파일
정상 응답은 파일 본문입니다. 실패 시 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.
편집한 문서를 DOCX로 받습니다. 같은 문서의 구매한 내용은 보관기간 내 재다운로드가 무료입니다.
https://apick.app/rest/document_download왜 문서 DOCX 다운로드인가
편집한 문서를 다른 프로그램에서 열거나 제출하려면 표준 파일이 필요합니다. 편집한 문서를 DOCX로 받고, 같은 문서의 구매한 내용은 보관기간 안에 다시 받아도 무료입니다.
document_create로 문서를 만들고 document_get으로 엽니다. 편집 후 document_update에 현재 version을 넣어 저장합니다. document_quote의 version과 content_hash를 document_download에 전달하면 DOCX를 받습니다. 수정 충돌은 409로 알려 줍니다.
문서 JSON 예: {"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"회의 내용"}]}]}
문단(paragraph), 제목(heading), 표(table), 목록(bulletList·orderedList), 텍스트(text), 서명(image), 페이지 나누기(pageBreak)를 지원합니다. 굵게(bold), 기울임(italic), 밑줄(underline), 글꼴·크기·색상(textStyle)을 지정할 수 있습니다. 본문은 100,000자, 이미지 6개까지이며 서명은 PNG·JPEG data URL 각 300KB 이하입니다.
핵심 문서 작성 기능은 평가 중입니다. document_templates에서 작성 기준을 확인하고 document_workflow_quote의 견적을 확인한 뒤 request_id와 max_points로 document_workflow_start를 요청합니다. document_workflow_get으로 질문과 초안을 확인하고, 추가 답변은 새 요청 ID와 한도로 document_workflow_answer에 보냅니다. document_workflow_apply로 문서함에 저장하며 document_workflow_cancel로 미완료 작업을 취소합니다. 같은 접수의 재시도에는 기존 request_id를 유지합니다.
분석 한 단계는 20P이며 추가 답변과 다운로드는 별도입니다. 문서 수정은 현재 버전이 일치할 때만 적용됩니다. document_verify는 자료와 일치·사용자 확인·공식 근거 확인·상충·확인 불가·최신성 확인 필요를 구분합니다. 확인할 수 없는 내용은 검증 완료가 아닙니다. document_finalize는 현재 버전의 검증 해시가 일치하고 차단 항목이 없을 때만 확정합니다. 문서를 수정하거나 첨부가 바뀌면 다시 검증해야 합니다.
현재 공식 요건을 확인하지 못한 문서는 확정할 수 없습니다. 개인 경력이나 거래 실재 여부를 보장하지 않으며 법적 효력을 자동으로 판단하지 않습니다. 첨부 자료를 읽거나 대조할 수 없는 경우에도 확인 불가로 표시합니다.
document_attachment_add·list·remove로 첨부를 관리합니다. document_download_pdf는 PDF, document_download_bundle은 DOCX와 첨부 ZIP을 제공합니다. 기존 문서 견적의 version과 content_hash를 사용하며 같은 문서의 구매한 내용은 출력 형식이 달라도 보관기간 내 다시 다운로드할 수 있습니다.
최초 100P · 같은 내용 재다운로드 무료. 저장·열기·목록·수정·삭제·견적은 무료입니다. 공개 API AI 작성은 성공당 20P이며 웹의 하루 20회 무료 체험과 별도입니다. DOCX 다운로드는 최초 100P이며 같은 문서에서 구매한 내용은 무료로 다시 받습니다. 내용이 바뀌면 새로운 다운로드 가격을 확인해 주세요.
문서는 최초 저장 또는 마지막 수정·다운로드 후 14일간 보관합니다. 열기와 변경 없는 저장은 기한을 연장하지 않습니다. 기한이 지나면 문서와 파일이 삭제됩니다. 본인 문서만 사용할 수 있으며 없는 문서·만료 문서는 404, 잔액 부족은 402로 알려 줍니다. 실패한 AI 작업과 파일 생성은 차감하지 않습니다.
/rest/document_downloaddocument_id입력값version1content_hash입력값request_id입력값정상 응답은 파일 본문입니다. 실패 시 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.
POST https://apick.app/rest/document_download · JSON · Authorization: Bearer 인증키
HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.