문서 생성
POST /v1/documentsdraft 상태의 새 문서를 만듭니다.
본문 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
title |
string | ✔ | 문서 제목 |
content |
string | △ | 계약 본문 HTML. file_url과 택일 |
file_url |
string | △ | 업로드한 PDF의 URL. content와 택일 |
author_name |
string | 발송 주체 표시명(기본: 조직명) | |
metadata |
object | 자유 key-value (최대 20개) |
요청 예시
curl https://api.pactery.com/v1/documents \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"title": "업무 위탁 계약서",
"content": "<h1>업무 위탁 계약서</h1><p>...</p>",
"metadata": { "order_id": "2026-0605-0001" }
}'응답 (201)
{
"id": "doc_8sK2...",
"object": "document",
"status": "draft",
"title": "업무 위탁 계약서",
"created_at": "2026-06-05T09:30:00+09:00"
}에러
| code | 의미 |
|---|---|
missing_parameter |
title 누락 또는 content/file_url 둘 다 없음 |
invalid_parameter |
metadata 키 20개 초과 등 형식 오류 |
같은
Idempotency-Key로 본문만 바꿔 다시 보내면idempotency_key_reused가 납니다. 새 문서엔 새 키를 쓰세요.