# 서식·판본 불러오기



서식과 선택한 판본의 편집 문서를 불러옵니다.



인증: Authorization: Bearer $APICK_API_KEY

요청 본문: application/json. 문서 JSON과 숫자 버전을 그대로 전달합니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/document_template 응답 필드

## API 요청: POST /rest/document_template



### 입력

- `form` (string, 필수): 서식 키 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.

- `edition` (string, 선택): 판본 ID 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST "https://apick.app/rest/document_template" \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @document-request.json
# document-request.json에 아래 JSON을 저장하고 요청 ID와 문서 식별자를 바꿉니다.
# {"form":"ops_proposal"}

```

### Node.js (서버 ESM)

```javascript

const body = {
  "form": "ops_proposal"
};
const response = await fetch("https://apick.app/rest/document_template", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify(body), signal: AbortSignal.timeout(120_000)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

```

### python

```python

import os, json, requests
body = json.loads("{\"form\":\"ops_proposal\"}")
response = requests.post("https://apick.app/rest/document_template", json=body, headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, timeout=120)
response.raise_for_status()
print(response.json())

```

### php

```php

<?php
$body = json_decode('{"form":"ops_proposal"}', true);
$curl = curl_init("https://apick.app/rest/document_template");
curl_setopt_array($curl, [CURLOPT_POST => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("APICK_API_KEY"), "Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode($body), CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 120]);
$result = curl_exec($curl);
if ($result === false || curl_getinfo($curl, CURLINFO_HTTP_CODE) >= 400) throw new RuntimeException("문서 요청 실패");
curl_close($curl);
echo $result;

```

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요.

```json

{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}

```

## 상세 기능·요금

문서 작성 순서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를 사용하며 같은 문서의 구매한 내용은 출력 형식이 달라도 보관기간 내 다시 다운로드할 수 있습니다. 가격과 보관무료. 저장·열기·목록·수정·삭제·견적은 무료입니다. 공개 API AI 작성은 성공당 20P이며 웹의 하루 20회 무료 체험과 별도입니다. DOCX 다운로드는 최초 100P이며 같은 문서에서 구매한 내용은 무료로 다시 받습니다. 내용이 바뀌면 새로운 다운로드 가격을 확인해 주세요.문서는 최초 저장 또는 마지막 수정·다운로드 후 14일간 보관합니다. 열기와 변경 없는 저장은 기한을 연장하지 않습니다. 기한이 지나면 문서와 파일이 삭제됩니다. 본인 문서만 사용할 수 있으며 없는 문서·만료 문서는 404, 잔액 부족은 402로 알려 줍니다. 실패한 AI 작업과 파일 생성은 차감하지 않습니다.

## 상세 요청

POST https://apick.app/rest/document_template · JSON · Authorization: Bearer 인증키
