{"openapi":"3.0.3","info":{"title":"APICK 등기 변동 모니터링","version":"1.0.0","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/iros_monitor":{"post":{"summary":"등기 변동 모니터링","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.","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":{"target_type":{"type":"string","description":"대상 유형입니다. realestate(부동산) | corporation(법인). (string)","example":"realestate"},"duration_days":{"type":"string","description":"변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다. (number)","example":"365"},"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":"부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"},"bubn":{"type":"string","description":"부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"},"corp_name":{"type":"string","description":"법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다. (string)"},"corp_reg_no":{"type":"string","description":"법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000). (string)"},"idempotency_key":{"type":"string","description":"같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다. (string)"}},"required":["target_type"]}}}}}},"/rest/iros_monitor/status":{"post":{"summary":"등기 변동 모니터링","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.","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":{"target_type":{"type":"string","description":"대상 유형입니다. realestate(부동산) | corporation(법인). (string)","example":"입력값"},"duration_days":{"type":"string","description":"변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다. (number)"},"sido_nm":{"type":"string","description":"부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sgg_nm":{"type":"string","description":"부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emd_nm":{"type":"string","description":"부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ri_nm":{"type":"string","description":"리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bobn":{"type":"string","description":"부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bubn":{"type":"string","description":"부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"corp_name":{"type":"string","description":"법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다. (string)"},"corp_reg_no":{"type":"string","description":"법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000). (string)"},"idempotency_key":{"type":"string","description":"같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다. (string)"}},"required":["target_type"]}}}}}},"/rest/iros_monitor/changed":{"post":{"summary":"등기 변동 모니터링","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.","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":{"target_type":{"type":"string","description":"대상 유형입니다. realestate(부동산) | corporation(법인). (string)","example":"입력값"},"duration_days":{"type":"string","description":"변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다. (number)"},"sido_nm":{"type":"string","description":"부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sgg_nm":{"type":"string","description":"부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emd_nm":{"type":"string","description":"부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ri_nm":{"type":"string","description":"리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bobn":{"type":"string","description":"부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bubn":{"type":"string","description":"부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"corp_name":{"type":"string","description":"법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다. (string)"},"corp_reg_no":{"type":"string","description":"법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000). (string)"},"idempotency_key":{"type":"string","description":"같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다. (string)"}},"required":["target_type"]}}}}}},"/rest/iros_monitor/list":{"post":{"summary":"등기 변동 모니터링","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.","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":{"target_type":{"type":"string","description":"대상 유형입니다. realestate(부동산) | corporation(법인). (string)","example":"입력값"},"duration_days":{"type":"string","description":"변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다. (number)"},"sido_nm":{"type":"string","description":"부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sgg_nm":{"type":"string","description":"부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emd_nm":{"type":"string","description":"부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ri_nm":{"type":"string","description":"리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bobn":{"type":"string","description":"부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bubn":{"type":"string","description":"부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"corp_name":{"type":"string","description":"법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다. (string)"},"corp_reg_no":{"type":"string","description":"법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000). (string)"},"idempotency_key":{"type":"string","description":"같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다. (string)"}},"required":["target_type"]}}}}}},"/rest/iros_monitor/terminate":{"post":{"summary":"등기 변동 모니터링","description":"부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.","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":{"target_type":{"type":"string","description":"대상 유형입니다. realestate(부동산) | corporation(법인). (string)","example":"입력값"},"duration_days":{"type":"string","description":"변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다. (number)"},"sido_nm":{"type":"string","description":"부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sgg_nm":{"type":"string","description":"부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emd_nm":{"type":"string","description":"부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ri_nm":{"type":"string","description":"리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bobn":{"type":"string","description":"부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bubn":{"type":"string","description":"부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"corp_name":{"type":"string","description":"법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다. (string)"},"corp_reg_no":{"type":"string","description":"법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000). (string)"},"idempotency_key":{"type":"string","description":"같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다. (string)"}},"required":["target_type"]}}}}}}},"x-code-tables":[{"title":"대상별 상태 조회 요청","columns":["파라미터","타입","필수","설명"],"rows":[["target_id","string","필수","등록 응답으로 받은 대상 ID입니다."]]},{"title":"오류","columns":["error_code","의미","대처"],"rows":[["IROS_MONITOR_TARGET_TYPE_INVALID","대상 유형이 올바르지 않습니다(400).","target_type 값을 확인합니다."],["IROS_MONITOR_TARGET_REQUIRED","대상 정보가 빠졌거나 형식이 다릅니다(400).","주소·지번 또는 법인명·법인등록번호 값을 확인합니다."],["IROS_MONITOR_DURATION_OUT_OF_RANGE","기간이 범위를 벗어났습니다(400).","duration_days를 1~1000으로 지정합니다."],["IROS_MONITOR_LIMIT_EXCEEDED","모니터링 대상 수가 한도를 넘었습니다.","끝난 대상을 정리하거나 기존 대상을 종료한 뒤 등록합니다."],["IROS_MONITOR_POINTS_INSUFFICIENT","포인트가 부족합니다.","충전 후 다시 등록합니다."],["IROS_MONITOR_TARGET_NOT_FOUND","대상을 찾을 수 없습니다(404).","target_id를 확인합니다."],["IROS_MONITOR_ALREADY_ENDED","이미 종료된 대상입니다.","다시 모니터링하려면 새로 등록합니다."],["IROS_MONITOR_TEMPORARILY_UNAVAILABLE","일시적으로 처리할 수 없습니다.","잠시 후 다시 시도합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}