Skip to main content

API 개요

딸깍문서 REST API의 전체 구조와 공통 사항을 안내합니다.

기본 정보​

항목값
Base URLhttps://your-domain.com/api
프로토콜HTTPS
형식JSON
인증NextAuth.js Session

API 카테고리​

Document API​

문서 CRUD 및 AI 기능

메서드엔드포인트설명
POST/api/document문서 생성
GET/api/document/{id}문서 조회
PATCH/api/document/{id}문서 수정
DELETE/api/document/{id}문서 삭제
POST/api/document/complete-streamAI 스트리밍
POST/api/document/exportDOCX 내보내기
POST/api/document/export-pdfPDF 내보내기

PDF API​

PDF 처리 관련 기능

메서드엔드포인트설명
POST/api/pdf/detect-blanksAI 빈칸 감지
POST/api/pdf/fill-blanks빈칸 채우기
POST/api/pdf/extract-fields필드 추출
POST/api/pdf/ocr-region영역 OCR

OCR API​

이미지 텍스트 추출

메서드엔드포인트설명
POST/api/ocr/claude-vision단일 OCR
POST/api/ocr/claude-vision-batch배치 OCR

기타 API​

메서드엔드포인트설명
POST/api/translate번역
GET/api/templates템플릿 목록
POST/api/feedback피드백 제출

공통 응답 형식​

성공 응답​

{
  "success": true,
  "data": { ... }
}

에러 응답​

{
  "error": "Error message",
  "details": "Detailed error information"
}

HTTP 상태 코드​

코드의미
200성공
201생성됨
400잘못된 요청
401인증 필요
403권한 없음
404리소스 없음
500서버 오류

Rate Limiting​

플랜제한
무료60 req/min
프리미엄300 req/min

다음 단계​