{"openapi":"3.0.3","info":{"title":"APICK 부동산종합증명서 열람","version":"1.0.0","description":"토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/kras_cert_jobs":{"post":{"summary":"부동산종합증명서 열람","description":"토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"sido_nm":{"type":"string","description":"시·도 이름 (예: 서울특별시) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"경기도"},"sgg_nm":{"type":"string","description":"시·군·구 이름 (예: 강남구) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"성남시 분당구"},"emd_nm":{"type":"string","description":"읍·면·동 이름 (예: 역삼동) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"정자동"},"ri_nm":{"type":"string","description":"리 이름 (읍·면 지역일 때) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bobn":{"type":"string","description":"본번 (예: 123) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"1"},"bubn":{"type":"string","description":"부번 (없으면 생략) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"},"real_gbn":{"type":"string","description":"토지(L)·건물(B)·집합건물(M), 기본 L 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. L = L 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. B = 주요사항보고(B)입니다. 합병·분할·대규모 계약처럼 중요한 사건이 생겼을 때 공시됩니다. M = M 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["L","B","M"],"example":"L"},"doc_format":{"type":"string","description":"받을 형식. PDF 를 원하면 pdf (JSON 결과는 항상 조회됩니다) 가능한 값은 2가지입니다. json = json 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. pdf = pdf 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["json","pdf"]},"idempotency_key":{"type":"string","description":"같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. 키를 생략할 수 있는 API에서 생략하면 같은 요청은 기존 작업으로 처리됩니다. (string)"}},"required":["sido_nm","sgg_nm","emd_nm","bobn"]}}}}}},"/rest/kras_cert_jobs/status":{"post":{"summary":"부동산종합증명서 열람","description":"토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"접수에서_반환한_ID"}},"required":["job_id"]}}}}}},"/rest/kras_cert_jobs/pdf":{"post":{"summary":"부동산종합증명서 열람","description":"토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"접수에서_반환한_ID"}},"required":["job_id"]}}}}}}},"x-code-tables":[{"title":"오류","columns":["error_code","의미","대처"],"rows":[["KRAS_CERT_BAD_REQUEST","요청 값이 올바르지 않습니다(400).","주소·지번 값을 확인합니다."],["KRAS_CERT_POINTS_INSUFFICIENT","포인트가 부족합니다.","충전 후 다시 접수합니다."],["KRAS_CERT_IDEMPOTENCY_CONFLICT","같은 멱등키의 다른 요청이 이미 접수되어 있습니다.","같은 요청이면 job_id를 확인하고, 다른 요청이면 새 키로 보냅니다."],["KRAS_CERT_JOB_NOT_FOUND","작업을 찾을 수 없습니다.","job_id를 확인합니다."],["KRAS_CERT_PDF_NOT_READY","PDF가 아직 준비되지 않았습니다.","작업이 완료된 뒤 다운로드합니다."],["KRAS_CERT_PDF_EXPIRED","보관 기한이 지난 결과입니다(410).","다시 접수합니다."],["KRAS_CERT_TEMPORARILY_UNAVAILABLE","일시적으로 처리할 수 없습니다.","잠시 후 다시 시도합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}