개발자 API

등기 변환을 시스템에 연동하세요

사무소 내부 시스템에서 REST API로 등기 PDF를 제출하고, 통합 엑셀을 자동으로 받아옵니다. API 키 발급은 ENTERPRISE 플랜에서 가능합니다.

API 키 관리

키는 발급 시 1회만 표시됩니다. 노출된 키는 즉시 폐기하고 재발급하세요.

ENTERPRISE 전용로그인

API 레퍼런스

베이스 URL: https://deungi.cloud · 인증: 모든 요청 헤더에 Authorization: Bearer <API키> (또는 X-API-Key)

메서드경로설명
POST/api/v1/convertPDF 업로드 → 변환 작업 생성(job_id 반환)
GET/api/v1/jobs/{job_id}작업 상태(queued·running·done·failed)
GET/api/v1/jobs/{job_id}/result완료된 엑셀 다운로드(1회)
등기 열람 API (열람권 1장/건)
POST/api/v1/registry/search주소 검색 → 후보 목록(무료). search_id·idx 반환
POST/api/v1/registry/read후보 1건 열람요청(비동기·열람권 1장 차감). read_id 반환
GET/api/v1/registry/read/{read_id}열람 상태·결과(reading·done·failed)
GET/api/v1/registry/read/{read_id}/pdf?idx=0등기 PDF 스트리밍

열람요청(/read) 선택 파라미터 — callback_url: 완료 시 {read_id,status} 웹훅 POST 받을 URL(받은 뒤 자기 키로 GET 재조회).
※ 건축물대장·토지대장·지적도 등 대장류는 API로 제공하지 않습니다(등기 열람만). 대장 발급은 웹에서 이용해 주세요.

빠른 시작 — cURL
# 1) 변환 작업 제출 (PDF 여러 개 + 직군 템플릿 선택)
curl -X POST https://deungi.cloud/api/v1/convert \
  -H "Authorization: Bearer dgk_..." \
  -F "files=@등기1.pdf" -F "files=@등기2.pdf" \
  -F "template=agent"
# → {"job_id":"a1b2c3","status":"queued","count":2}

# 2) 상태 조회 (완료되면 download_url 제공)
curl https://deungi.cloud/api/v1/jobs/a1b2c3 \
  -H "Authorization: Bearer dgk_..."
# → {"status":"done","count":2,"download_url":"/api/v1/jobs/a1b2c3/result"}

# 3) 결과 엑셀 다운로드 (1회, 이후 서버에서 삭제)
curl -L https://deungi.cloud/api/v1/jobs/a1b2c3/result \
  -H "Authorization: Bearer dgk_..." -o 등기목록.xlsx
등기 열람 — cURL
# 1) 주소 검색(무료) → 후보 목록
curl -X POST https://deungi.cloud/api/v1/registry/search \
  -H "Authorization: Bearer dgk_..." \
  -F "address=서울 종로구 가회동 1-11"
# → {"search_id":"s1","candidates":[{"idx":0,"address":"...","type":"토지",...}]}

# 2) 열람요청(열람권 1장 차감, 비동기)
curl -X POST https://deungi.cloud/api/v1/registry/read \
  -H "Authorization: Bearer dgk_..." \
  -F "search_id=s1" -F "idx=0"
# → {"read_id":"r1","status":"reading"}

# 3) 상태 폴링(수 초~1분) — status가 done이 될 때까지
curl https://deungi.cloud/api/v1/registry/read/r1 \
  -H "Authorization: Bearer dgk_..."
# → {"status":"done","items":[{"idx":0,"title":"등기사항전부증명서","address":"..."}]}

# 4) 등기 PDF 다운로드
curl -L "https://deungi.cloud/api/v1/registry/read/r1/pdf?idx=0" \
  -H "Authorization: Bearer dgk_..." -o 등기부등본.pdf

파라미터

제한

이용 조건 · 금지사항

본 API는 회원 본인의 업무용 열람 목적으로만 제공됩니다.
앱 다운로드