1API 요청
/rest/iros_monitor요청 파라미터 11개 · 필수 1
target_type- 예시
realestate
duration_days- 예시
365
sido_nm- 예시
경기도
sgg_nm- 예시
성남시 분당구
emd_nm- 예시
정자동
ri_nmbobn- 예시
1
bubn- 예시
1
corp_namecorp_reg_noidempotency_key응답 필드
이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.
왜 등기 변동 모니터링인가
등기부를 열람하지 않고도 부동산·법인의 새 등기 신청과 진행 상태 변화를 매일 확인합니다. 변동이 감지되면 내용을 저장해 알려주고 모니터링을 끝내므로, 감지한 그 확인까지만 과금되고 이후 비용은 없습니다.
모니터링할 대상 등록과 대상별 상태 조회, 변동 감지 대상 묶음 조회, 전체 목록(무료), 모니터링 종료(무료) API로 나뉩니다. 등록 직후 1회 변동 검사를 바로 수행해 최초 기록을 남기고(status: "monitoring"), 이후 매일 1회씩 자동으로 변동 여부를 확인합니다. 변동이 감지되면 감지된 내용을 저장하고 상태를 changed로 바꿔 모니터링을 끝냅니다(그 이후로는 추가 과금이 없습니다).
target_id·status: "monitoring"status·변동 시 changedtargets 목록targets 목록(변동 정보 없음)status: "terminated"본인이 등록한 모니터링 대상 중 변동이 감지된 것만 모아서 돌려줍니다(건당 20P). 변동이 감지된 대상이 없으면 과금 없이 빈 목록이 옵니다.
changed로 바꿔 모니터링을 끝냅니다. 그 확인까지만 과금되고 이후로는 추가 과금이 없습니다./rest/iros_monitortarget_typerealestateduration_days365sido_nm경기도sgg_nm성남시 분당구emd_nm정자동ri_nmbobn1bubn1corp_namecorp_reg_noidempotency_key이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/iros_monitor/statustarget_type입력값duration_dayssido_nmsgg_nmemd_nmri_nmbobnbubncorp_namecorp_reg_noidempotency_key이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/iros_monitor/changedtarget_type입력값duration_dayssido_nmsgg_nmemd_nmri_nmbobnbubncorp_namecorp_reg_noidempotency_key이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/iros_monitor/listtarget_type입력값duration_dayssido_nmsgg_nmemd_nmri_nmbobnbubncorp_namecorp_reg_noidempotency_key이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
/rest/iros_monitor/terminatetarget_type입력값duration_dayssido_nmsgg_nmemd_nmri_nmbobnbubncorp_namecorp_reg_noidempotency_key이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.
등록에 성공하면 target_id가 발급되고, 등록 즉시 1회 변동 검사를 수행해 최초 기록을 남깁니다(50P). 이 기준 기록과 비교해 매일 1회씩 새로 접수된 사건이나 진행 상태 변화가 있는지 확인합니다.
종료(terminated)되거나 변동이 감지(changed)되거나 기간이 지나(expired) 모니터링이 끝난 대상은 다시 시작할 수 없습니다. 다시 모니터링하려면 대상 등록 API로 새로 등록해 주세요.
HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
data.target_id·data.status: "monitoring"·data.duration_daysdata.status: "monitoring", check_count·last_check_at·next_check_at로 확인 횟수와 다음 확인 시각을 알 수 있습니다.data.status: "changed", data.changed(감지 시각·새로 접수된 사건·진행 상태 변화)·data.changed_atdata.status: "terminated"·data.terminated_atdata.status: "expired"응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}오류는 data.error(안내 문구)와 data.error_code로 옵니다.
target_type 값을 확인합니다.duration_days를 1~1000으로 지정합니다.target_id를 확인합니다.FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.