접수(제출)와 상태·결과 조회(조회), PDF 다운로드(다운로드) 세 API로 나뉩니다. 접수 직후 200P가 예약 차감되고 job_id와 status(waiting)를 돌려줍니다. 완료되면 상태 조회가 원문 내용(JSON)을, 다운로드가 PDF 문서를 응답합니다(다운로드는 무료).
Method
API entry point
기능
성공 결과
POST
/rest/kras_cert_jobs
열람 접수(200P 예약 차감)
job_id·status: "waiting"
POST
/rest/kras_cert_jobs/status
상태·결과(JSON) 조회(무료)
status·완료 시 result
POST
/rest/kras_cert_jobs/pdf
PDF 문서 다운로드(무료)
application/pdf
과금·환급
항목
설명
단가
건당 200P입니다.
과금 시점
접수 직후 200P 예약 차감이고, 완료되면 확정됩니다.
상태 조회·PDF 다운로드
무료(0P)입니다.
환급
조회가 실패(failed)하거나 처리 기한을 넘기면 예약 차감한 200P를 전액 환급합니다. 별도 호출이 필요 없습니다.
처리 제한 시간
접수 후 최대 180초까지 작업을 처리합니다. 넘기면 실패(환급)로 끝납니다.
요청과 응답
1API 요청
POST/rest/kras_cert_jobs
Bearer 인증
multipart/form-data
JSON 응답
요청 파라미터 9개 · 필수 4
파라미터
설명
sido_nmstring필수
시·도 이름 (예: 서울특별시) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
최대 길이
40자
예시
경기도
sgg_nmstring필수
시·군·구 이름 (예: 강남구) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
최대 길이
40자
예시
성남시 분당구
emd_nmstring필수
읍·면·동 이름 (예: 역삼동) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
최대 길이
40자
예시
정자동
ri_nmstring선택
리 이름 (읍·면 지역일 때) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
최대 길이
40자
bobnstring필수
본번 (예: 123) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
형식
^[0-9]{1,4}$
예시
1
bubnstring선택
부번 (없으면 생략) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
형식
^[0-9]{1,4}$
예시
1
real_gbnstring선택
토지(L)·건물(B)·집합건물(M), 기본 L 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. L = L 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. B = 주요사항보고(B)입니다. 합병·분할·대규모 계약처럼 중요한 사건이 생겼을 때 공시됩니다. M = M 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요.
허용값
LBM
예시
L
doc_formatstring선택
받을 형식. PDF 를 원하면 pdf (JSON 결과는 항상 조회됩니다) 가능한 값은 2가지입니다. json = json 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. pdf = pdf 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요.
허용값
jsonpdf
idempotency_keystring선택
같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. 키를 생략할 수 있는 API에서 생략하면 같은 요청은 기존 작업으로 처리됩니다.
최대 길이
64자
응답 필드
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
2API 요청
POST/rest/kras_cert_jobs/status
Bearer 인증
multipart/form-data
JSON 응답
요청 파라미터 1개 · 필수 1
파라미터
설명
job_idstring필수
접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
형식
^[a-f0-9]{32}$
예시
접수에서_반환한_ID
응답 필드
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
3API 요청
POST/rest/kras_cert_jobs/pdf
Bearer 인증
multipart/form-data
파일 응답
요청 파라미터 1개 · 필수 1
파라미터
설명
job_idstring필수
접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.
형식
^[a-f0-9]{32}$
예시
접수에서_반환한_ID
응답 필드 파일
정상 응답은 파일 본문입니다. 실패 시 JSON 오류가 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.
HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
무료 포인트로 사용할 수 없는 서비스입니다.
200
최소 1회 결제 후 이용할 수 있습니다. result.error 전체 문구를 그대로 표시하세요.
인증 정보를 확인할 수 없습니다.
424
일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.
폼 입력 오류 error.code
코드
HTTP
의미·조치
FORM_DATA_INVALID
400
필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.
FORM_DATA_FIELD_CONFLICT
400
같은 값과 중첩 경로를 동시에 지정하지 마세요.
MULTIPART_LIMIT_OR_PARSE_ERROR
400·413
boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.
요금·이용 조건
기본 요금열람 200P무료 포인트로는 이용할 수 없으며 최소 1회 결제 후 이용할 수 있습니다.
실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
연동 팁
요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.
부동산종합증명서 열람
토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다.
지원 API 요약
접수(제출)와 상태·결과 조회(조회), PDF 다운로드(다운로드) 세 API로 나뉩니다. 접수 직후 200P가 예약 차감되고 job_id와 status(waiting)를 돌려줍니다. 완료되면 상태 조회가 원문 내용(JSON)을, 다운로드가 PDF 문서를 응답합니다(다운로드는 무료).
Method
API entry point
기능
성공 결과
POST
/rest/kras_cert_jobs
열람 접수(200P 예약 차감)
job_id·status: "waiting"
POST
/rest/kras_cert_jobs/status
상태·결과(JSON) 조회(무료)
status·완료 시 result
POST
/rest/kras_cert_jobs/pdf
PDF 문서 다운로드(무료)
application/pdf
접수 요청
파라미터
타입
필수
설명
sido_nm
string
필수
시·도 이름입니다(예: 경기도).
sgg_nm
string
필수
시·군·구 이름입니다(예: 성남시 분당구).
emd_nm
string
필수
읍·면·동 이름입니다(예: 정자동).
ri_nm
string
선택
리 이름입니다. 읍·면 지역일 때 넣습니다.
bobn
string
필수
본번(숫자 1~4자리)입니다.
bubn
string
선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다.
real_gbn
string
선택
조회 대상 유형입니다. L(토지) | B(건물) | M(복합). 기본 L.
doc_format
string
선택
원하는 결과 형식입니다. json | pdf. 기본 json. PDF 문서는 언제나 다운로드 API로 받을 수 있습니다.
reg_no_expr
boolean
선택
주민등록번호 표시 여부입니다. 기본 false.
idempotency_key
string
선택
같은 요청을 두 번 접수·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 작업을 돌려줍니다.