서식 자동작성 API 개발가이드

알아둘 점

이럴 때 씁니다

상황

보내는 값

상담 내용을 근로계약서로 정리

상담 메모 문장 그대로

고객이 입력한 값으로 견적서 발급

이름·금액·항목을 필드로

사내 시스템에서 재직증명서 자동 발급

인사 데이터 필드

임대차 조건을 문장으로 받아 계약서 생성

문장 + 보증금·기간 필드

지원 포맷

format

결과

쓰는 곳

pdf

application/pdf

인쇄·제출용

docx

application/vnd.openxmlformats-officedocument.wordprocessingml.document

Word·한글에서 편집

rtf

application/rtf

한글·Word 호환

html

text/html; charset=utf-8

웹 미리보기

md

text/markdown; charset=utf-8

문서화

txt

text/plain; charset=utf-8

평문

json

application/json; charset=utf-8

값 추출·연동

xlsx

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

값 검수 시트

지원 서식 50종

서식

form

분류

항목

표준근로계약서

labor_contract_standard

노무

22개(필수 4)

기간제 근로계약서

labor_contract_fixed_term

노무

18개(필수 5)

단시간 근로계약서

labor_contract_part_time

노무

17개(필수 4)

연봉계약서

labor_contract_annual_salary

노무

14개(필수 4)

재직증명서

hr_employment_certificate

노무

15개(필수 5)

경력증명서

hr_career_certificate

노무

12개(필수 5)

사직서

hr_resignation

노무

10개(필수 4)

휴직원

hr_leave_request

노무

10개(필수 5)

연차휴가 신청서

hr_annual_leave

노무

12개(필수 6)

비밀유지계약서(NDA)

biz_nda

노무

12개(필수 3)

주택임대차 표준계약서

re_lease_housing

부동산

19개(필수 7)

상가건물 임대차계약서

re_lease_commercial

부동산

18개(필수 7)

부동산 매매계약서

re_sale_contract

부동산

19개(필수 6)

계약금 영수증

re_deposit_receipt

부동산

10개(필수 5)

임대차 해지 합의서

re_lease_termination

부동산

12개(필수 5)

관리비 부과 명세서

re_maintenance_statement

부동산

18개(필수 6)

시설 수리 요청서

re_repair_request

부동산

10개(필수 4)

주택임대차 신고서

re_lease_report

부동산

15개(필수 7)

사업자등록 신청서

biz_registration_application

사업

15개(필수 8)

폐업신고서

biz_closure_report

사업

10개(필수 5)

사업자등록 정정신고서

biz_correction_report

사업

9개(필수 5)

간이과세자 부가가치세 신고서

tax_vat_simple_return

세무

10개(필수 6)

견적서

biz_estimate

사업

18개(필수 6)

거래명세서

biz_transaction_statement

사업

14개(필수 7)

세금계산서 발행 요청서

biz_tax_invoice_request

세무

13개(필수 8)

용역계약서(프리랜서)

biz_service_contract

사업

17개(필수 8)

물품구매계약서

biz_purchase_contract

사업

17개(필수 7)

영수증

biz_receipt

세무

10개(필수 5)

차용증

loan_promissory_note

금융

16개(필수 6)

금전소비대차계약서

loan_contract

금융

14개(필수 6)

임금명세서

hr_pay_statement

노무

19개(필수 5)

수행확인서

ops_completion_cert

사업

10개(필수 6)

검수확인서

ops_inspection_cert

사업

11개(필수 6)

회의록

ops_meeting_minutes

운영

12개(필수 6)

업무보고서

ops_work_report

운영

10개(필수 6)

사업 제안서

ops_proposal

운영

13개(필수 6)

사업계획서

ops_business_plan

운영

14개(필수 5)

납품확인서

ops_delivery_note

사업

12개(필수 6)

개인정보 수집·이용 동의서

ops_privacy_consent

민원

11개(필수 6)

내용증명

civil_content_certification

민원

11개(필수 7)

위임장

civil_power_of_attorney

민원

12개(필수 5)

사실확인서

civil_fact_confirmation

민원

9개(필수 4)

합의서

civil_settlement

민원

12개(필수 5)

각서

civil_memo

민원

9개(필수 5)

진정서

civil_petition

민원

11개(필수 7)

정보공개 청구서

civil_info_disclosure

민원

11개(필수 7)

이력서

hr_resume

채용

12개(필수 3)

자기소개서

hr_cover_letter

채용

10개(필수 6)

입사지원서

hr_job_application

채용

15개(필수 5)

추천서

hr_recommendation

채용

10개(필수 6)

서식별 입력 항목과 예시는 /rest/form_fields 로 확인합니다. 예를 들어 {"form":"labor_contract_standard"} 를 보내면 필드 키·라벨·타입·필수 여부·예시가 돌아옵니다.

무료 API

경로

하는 일

과금

/rest/form_list

50종 목록·분류·필드 수. category·keyword 로 거릅니다.

무료

/rest/form_fields

서식 1종의 필드 정의(키·라벨·타입·필수·예시·선택지)

무료

/rest/form_preview

자유 텍스트에서 무엇이 인식됐고 무엇이 비었는지 미리 확인

무료

처음 연동할 때는 form_preview 로 인식 결과를 확인한 뒤 form_document 로 문서를 만드는 순서를 권합니다.

주의

결과물은 작성 보조 초안입니다. 법률·세무 자문이 아니며 서명·날인 전에는 효력이 없습니다. 주민등록번호 같은 민감정보는 문서 생성에만 쓰고 저장하지 않지만, 고객사 로그에 남기지 않도록 직접 관리해 주세요. 서식 문구는 법령 개정에 따라 달라질 수 있으므로 제출 전 최신 양식을 확인하세요.

요청과 응답

API 요청

POST/rest/form_document

Bearer 인증
multipart/form-data
JSON 응답

요청 예제

curl --fail-with-body --request POST 'https://apick.app/rest/form_document' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'form=labor_contract_standard' \
  --form-string '__apick_encoding[text]=base64-utf8' \
  --form-string 'text=7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==' \
  --form-string 'format=docx'

curl --fail-with-body --request POST 'https://apick.app/rest/form_document' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --form-string 'form=labor_contract_standard' \
  --form-string '__apick_encoding[text]=base64-utf8' \
  --form-string 'text=7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==' \
  --form-string 'format=docx'

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

const form = new FormData();
form.append("form", "labor_contract_standard");
form.append("__apick_encoding[text]", "base64-utf8");
form.append("text", "7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==");
form.append("format", "docx");
const response = await fetch("https://apick.app/rest/form_document", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

const form = new FormData();
form.append("form", "labor_contract_standard");
form.append("__apick_encoding[text]", "base64-utf8");
form.append("text", "7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==");
form.append("format", "docx");
const response = await fetch("https://apick.app/rest/form_document", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
if (result.error || result.data?.error || result.result?.error || result.success === false || result.api?.success === false) {
  throw new Error(JSON.stringify(result));
}
console.log(result);

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

import os
import requests
parts = [
    ("form", (None, "labor_contract_standard")),
    ("__apick_encoding[text]", (None, "base64-utf8")),
    ("text", (None, "7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==")),
    ("format", (None, "docx")),
]
response = requests.request("POST", "https://apick.app/rest/form_document",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

import os
import requests
parts = [
    ("form", (None, "labor_contract_standard")),
    ("__apick_encoding[text]", (None, "base64-utf8")),
    ("text", (None, "7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==")),
    ("format", (None, "docx")),
]
response = requests.request("POST", "https://apick.app/rest/form_document",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
if result.get("error") or (isinstance(result.get("data"), dict) and result["data"].get("error")) or (isinstance(result.get("result"), dict) and result["result"].get("error")) or result.get("success") is False or (result.get("api") or {}).get("success") is False:
    raise RuntimeError(result)
print(result)

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'form' => 'labor_contract_standard',
    '__apick_encoding[text]' => 'base64-utf8',
    'text' => '7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==',
    'format' => 'docx',
];
$curl = curl_init('https://apick.app/rest/form_document');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'form' => 'labor_contract_standard',
    '__apick_encoding[text]' => 'base64-utf8',
    'text' => '7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==',
    'format' => 'docx',
];
$curl = curl_init('https://apick.app/rest/form_document');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!empty($result["error"]) || !empty($result["data"]["error"]) || !empty($result["result"]["error"]) || ($result["success"] ?? true) === false || ($result["api"]["success"] ?? true) === false) {
    throw new RuntimeException($body);
}
print_r($result);

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

응답 예시

공개된 정적 응답 예제가 없는 경로입니다. 왼쪽 응답 필드에서 제공 범위를 확인하세요.

요청 파라미터 4개 · 필수 1

파라미터

설명

formstring필수

서식 키. 아래 50종 표 또는 /rest/form_list 에서 고릅니다.

예시: labor_contract_standard

textstring선택

자유 문장. 라벨: 값 형태가 아니어도 전화·주소·금액·날짜를 형식으로 인식합니다.

예시: 7IKs7JeF7LK066qFOiAo7KO8KeyXkOydtO2UvQrqt7zroZzsnpAg7ISx66qFOiDquYDssqDsiJgK7J6E6riI7JWhOiAz67Cx66eM7JuQCuq3vOuhnOqwnOyLnOydvDogMjAyNi0xMS0wMg==

dataobject선택

정형 필드. 같은 키는 text 보다 data 가 우선합니다. JSON 객체로 보내며, 하위 항목 이름과 값을 함께 지정합니다. 생략하면 서버 기본값이 적용됩니다.

formatstring선택

pdf(기본)·docx·rtf·html·md·txt·json·xlsx 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

예시: docx

응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

입력 조건·전송 규칙

응답은 파일 자체입니다. Content-Disposition 에 한글 파일명이, X-Form-Filled·X-Form-Total·X-Form-Missing 에 채움 정도와 빈 필수 항목이 실립니다. 문서(PDF·DOCX·RTF)는 100P, 값·미리보기 포맷(HTML·MD·TXT·JSON·XLSX)은 30P입니다.

form-data 전체 예제 보기

// 정형 필드만 보내는 경우. 없는 항목은 빈칸으로 출력됩니다.
{
  "form": "biz_estimate",
  "data": {
    "supplier_name": "(주)에이픽",
    "client_name": "(주)고객사",
    "estimate_date": "2026-11-02",
    "supply_amount": "12000000",
    "total_amount": "13200000"
  },
  "format": "pdf"
}

입력이 어떻게 채워지나

보낸 표기

문서에 들어가는 값

01012345678

010-1234-5678

9001011234567

900101-1234567

1234567890

123-45-67890

2026.1.1

2026-01-01

3백만원·1억 5천만원

3,000,000 원·150,000,000 원 (한글 금액 병기)

형식이 맞지 않는 값은 문서를 막지 않고 그 항목만 빈칸으로 두며, 응답의 X-Form-Missing 또는 JSON 포맷의 invalid 에 사유가 표시됩니다.

응답 처리

HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.

오류 코드

응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

HTTP 상태전송·인증·입력 오류
api.successAPI 처리 여부
data · result업무 결과와 오류 문구
api.cost이번 요청의 과금

업무 실패 응답 data.error

입력값이 맞지 않거나 대상 자료가 없거나 일시적으로 처리하지 못하면 data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.
이때 api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.
입력 오류(400)는 값을 고친 뒤 다시 요청하세요. 408·424는 잠시 후 한 번 다시 시도하고, 같은 입력으로 짧은 간격의 자동 반복은 하지 마세요.

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

인증·포인트 오류 result.error 문구

코드

HTTP

의미·조치

유효하지 않은 API키 입니다.

401

Authorization: Bearer 헤더의 인증키를 확인하세요.

허용되지 않은 IP주소 입니다.

401

마이페이지의 허용 IP 설정과 요청 서버 IP를 확인하세요.

비활성화된 계정입니다.

401

계정 이용 상태를 고객지원으로 문의하세요.

사용 가능한 포인트이 부족합니다.

200

HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.

인증 정보를 확인할 수 없습니다.

424

일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.

폼 입력 오류 error.code

코드

HTTP

의미·조치

FORM_DATA_INVALID

400

필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.

FORM_DATA_FIELD_CONFLICT

400

같은 값과 중첩 경로를 동시에 지정하지 마세요.

MULTIPART_LIMIT_OR_PARSE_ERROR

400·413

boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·이용 조건

기본 요금PDF·DOCX·RTF 100P / 값·미리보기 포맷 30P

실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.

연동 팁

요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.

서식 자동작성 API

알아둘 점

이럴 때 씁니다

지원 포맷

지원 서식 50종

무료 API

주의

요청과 응답

API 요청

요청 파라미터 4개 · 필수 1

응답 필드

입력 조건·전송 규칙

입력이 어떻게 채워지나

응답 처리

오류 코드

업무 실패 응답 data.error

인증·포인트 오류 result.error 문구

폼 입력 오류 error.code

요금·이용 조건

연동 팁

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드