{"openapi":"3.0.3","info":{"title":"APICK 건축물대장 등본 발급 접수","version":"1.0.0","description":"건축물대장 등본 발급을 접수합니다. 이용자 인증 없이 요청한 주소의 대장을 발급하고, 결과 조회에 쓸 transactionId 를 바로 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_building_register":{"post":{"summary":"건축물대장 등본 발급 접수","description":"건축물대장 등본 발급을 접수합니다. 이용자 인증 없이 요청한 주소의 대장을 발급하고, 결과 조회에 쓸 transactionId 를 바로 돌려줍니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"결과 조회에 사용하는 트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 결과조회에도 같은 값이 오므로 어느 항목의 결과인지 대조할 수 있습니다."},"status":{"type":"string","description":"처리 상태 (AUTH_REQUESTED: 접수 완료)"},"resultAvailable":{"type":"boolean","description":"결과 데이터 포함 여부. 접수 응답은 항상 false 입니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 접수에 성공하면 true 입니다."},"sources":{"type":"array","items":{}},"message":{"type":"string","description":"상태 메시지 (예: \"발급을 준비하고 있습니다.\")"},"approvals":{"type":"integer","description":"이용자 승인 횟수. 이용자 인증이 없으므로 0 입니다."},"expiresAt":{"type":"string"},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)"}},"description":"발급 접수 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"건물 주소. 시도·시군구를 뺀 도로명과 건물번호. 예: 세종대로 110 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"HRD-0000-0000"},"addrSe":{"type":"string","description":"주소 구분. 01 도로명, 02 지번. 기본 도로명 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"dngNo":{"type":"string","description":"동 코드(동 목록 조회 결과). 예: 01 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"dngNm":{"type":"string","description":"동명. 예: 101동 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"hoNm":{"type":"string","description":"호명. 예: 1001호 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"jihaYn":{"type":"string","description":"지하 구분. 0 지상, 1 지하 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ledgerSe":{"type":"string","description":"대장 구분. 일반(단독주택) 또는 집합(아파트·연립). 기본 일반 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"kind":{"type":"string","description":"대장 종류. 총괄·일반·다가구. 대장 구분이 일반일 때 쓴다. 기본 일반 (string)"},"part":{"type":"string","description":"세부 구분. 총괄·표제부·전유부·임대형기숙사. 대장 구분이 집합일 때 쓴다. 기본 표제부 (string)"},"receive":{"type":"string","description":"수령방법. 예: 0533|온라인발급(본인출력) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"}},"required":["address"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}