{"openapi":"3.0.3","info":{"title":"APICK 상가·오피스텔 기준시가","version":"1.0.0","description":"주소로 상가·오피스텔의 기준시가(㎡당 고시가격)를 조회합니다. 호실 단위 전용면적·호별 기준시가·고시일자를 함께 받아 양도·상속·증여세 계산과 담보 평가에 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/std_price_commercial":{"post":{"summary":"상가·오피스텔 기준시가","description":"주소로 상가·오피스텔의 기준시가(㎡당 고시가격)를 조회합니다. 호실 단위 전용면적·호별 기준시가·고시일자를 함께 받아 양도·상속·증여세 계산과 담보 평가에 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dong":{"type":"string","description":"법정동코드 10자리입니다."},"ji":{"type":"string","description":"번지(4자리)입니다."},"ho":{"type":"string","description":"조회에 쓴 지번의 호(부번지)입니다. 없으면 빈 값입니다."},"unit_no":{"type":"string","description":"조회한 호실 번호입니다. 호실을 지정하지 않았으면 빈 값입니다."},"address":{"type":"string","description":"주소로 조회했을 때 확정된 지번 주소입니다. 직접 입력 조회면 빈 값입니다."},"count":{"type":"integer","description":"돌려준 호실 수(items 길이)입니다. 고시된 건물이 없으면 0입니다."},"truncated":{"type":"boolean","description":"결과가 최대 50건을 넘어 잘렸는지입니다. unit_no를 보내 건물·호실을 좁히세요."},"items":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"gosi_date":{"type":"string"},"address":{"type":"string"},"ji":{"type":"string"},"ho":{"type":"string"},"block_name":{"type":"string"},"build_name":{"type":"string"},"floor_cd":{"type":"string"},"floor_no":{"type":"string"},"unit_no":{"type":"string"},"price_per_m2":{"type":"integer"},"area":{"type":"integer"},"share_area":{"type":"number"},"unit_std_price":{"type":"integer"}}},{}],"type":"object","properties":{"kind":{"type":"string","description":"종류입니다. 상가 또는 오피스텔입니다."},"gosi_date":{"type":"string","description":"고시일자(YYYY-MM-DD)입니다."},"address":{"type":"string","description":"법정동 주소입니다."},"block_name":{"type":"string","description":"건물(블록) 이름입니다."},"floor_cd":{"type":"string","description":"층 구분입니다. 예: 지상층, 지하층"},"floor_no":{"type":"string","description":"층 번호입니다."},"unit_no":{"type":"string","description":"호실 번호입니다."},"price_per_m2":{"type":"integer","description":"㎡당 고시가격(원)입니다."},"area":{"type":"number","description":"전용면적(㎡)입니다."},"share_area":{"type":"number","description":"공유면적(㎡)입니다."},"unit_std_price":{"type":"integer","description":"호실 기준시가(원)입니다. 고시가격 × 전용면적입니다."}}},"description":"호실별 기준시가 목록입니다. 없으면 빈 배열입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"과금 기록 번호입니다. 문의할 때 함께 알려 주세요."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"지번 또는 도로명 주소 (예: 서울특별시 동대문구 장안동 123) — dong·ji를 주지 않으면 필수 (string)","example":"서울특별시 동대문구 장안동 431"},"dong":{"type":"string","description":"법정동코드 10자리. address 대신 ji와 함께 직접 보낼 수 있습니다. (string)"},"ji":{"type":"string","description":"번지 (예: 431). address 대신 dong과 함께 직접 보낼 수 있습니다. (string)"},"ho":{"type":"string","description":"지번의 호(부번지). 건물을 특정할 때 씁니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"unit_no":{"type":"string","description":"호실 번호 (예: 101). 보내면 해당 호실만 돌려줍니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"101"}}}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["주소·코드 누락","400","주소 또는 법정동코드·번지가 필요합니다.","address 또는 dong+ji를 보냅니다."],["주소와 코드 중복 전송","400","주소와 법정동코드·번지는 함께 보내지 마세요.","둘 중 하나만 보냅니다."],["법정동코드 형식 오류","400","법정동코드 10자리를 올바르게 입력하세요.","숫자 10자리로 보냅니다."],["주소를 찾지 못함","424","주소 또는 PNU(19자리)가 필요합니다.","주소를 다시 확인해 보냅니다."],["일시적 조회 실패","424","상가·오피스텔 기준시가를 조회하지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}