{"openapi":"3.0.3","info":{"title":"APICK 부동산 등기 열람·발급 접수","version":"1.0.0","description":"검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/registry_realestate_jobs":{"post":{"summary":"부동산 등기 열람·발급 접수","description":"검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"reserved_point":{"type":"integer"},"download_point":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"},"pdf":{"type":"object","properties":{"bytes":{"type":"integer"},"pages":{"type":"integer"},"sha256":{"type":"string"},"expires_at":{"type":"string"},"download_point":{"type":"integer"}}}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"검색에 사용한 주소 또는 부동산고유번호 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"서울특별시 중구 세종대로 110"},"pin":{"type":"string","description":"부동산고유번호 14자리(선택) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"index":{"type":"string","description":"검색 결과 행 번호(1부터), 기본 1 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"1"},"usage":{"type":"string","description":"열람(view)·발급(issue) 등, 기본 view 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. view = view 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. issue = issue 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. transfer-gov24 = transfer-gov24 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. transfer-court = transfer-court 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["view","issue","transfer-gov24","transfer-court"],"example":"view"},"record_scope":{"type":"string","description":"전부(all)·일부(part), 기본 all 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 2가지입니다. all = all 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. part = part 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["all","part"]},"include_cancelled":{"type":"string","description":"말소사항 포함 여부, 기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"publish_resident_no":{"type":"string","description":"주민등록번호 공개 여부, 기본 false true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"idempotency_key":{"type":"string","description":"같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. (string)"}},"required":["query"]}}}}}},"/rest/registry_jobs/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1":{"get":{"summary":"부동산 등기 열람·발급 접수","description":"검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"reserved_point":{"type":"integer"},"download_point":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"},"pdf":{"type":"object","properties":{"bytes":{"type":"integer"},"pages":{"type":"integer"},"sha256":{"type":"string"},"expires_at":{"type":"string"},"download_point":{"type":"integer"}}}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/registry_jobs/{job_id}":{"get":{"summary":"부동산 등기 열람·발급 접수","description":"검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"reserved_point":{"type":"integer"},"download_point":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"},"pdf":{"type":"object","properties":{"bytes":{"type":"integer"},"pages":{"type":"integer"},"sha256":{"type":"string"},"expires_at":{"type":"string"},"download_point":{"type":"integer"}}}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/registry_jobs/{job_id}?download=1":{"get":{"summary":"부동산 등기 열람·발급 접수","description":"검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string"},"product":{"type":"string"},"status":{"type":"string"},"reserved_point":{"type":"integer"},"download_point":{"type":"integer"},"created_at":{"type":"string"},"completed_at":{"type":"string"},"pdf":{"type":"object","properties":{"bytes":{"type":"integer"},"pages":{"type":"integer"},"sha256":{"type":"string"},"expires_at":{"type":"string"},"download_point":{"type":"integer"}}}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-code-tables":[{"title":"상태 조회 응답","columns":["status","의미"],"rows":[["waiting","대기 중"],["processing","처리 중"],["completed","완료. ?download=1로 PDF 수신"],["failed","실패. error.code·error.message 확인, 880P 환급"]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}