# 등기 변동 모니터링



부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/iros_monitor 응답 필드

## API 요청: POST /rest/iros_monitor



### 입력

- `target_type` (string, 필수): 대상 유형입니다. realestate(부동산) | corporation(법인).

- `duration_days` (number, 선택): 변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.

- `sido_nm` (string, 조건부): 부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `sgg_nm` (string, 조건부): 부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `emd_nm` (string, 조건부): 부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `ri_nm` (string, 선택): 리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 조건부): 부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bubn` (string, 선택): 부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `corp_name` (string, 조건부): 법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.

- `corp_reg_no` (string, 조건부): 법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).

- `idempotency_key` (string, 선택): 같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/iros_monitor' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'target_type=realestate' \
  --form-string 'duration_days=365' \
  --form-string 'sido_nm=경기도' \
  --form-string 'sgg_nm=성남시 분당구' \
  --form-string 'emd_nm=정자동' \
  --form-string 'bobn=1' \
  --form-string 'bubn=1'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("target_type", "realestate");
form.append("duration_days", "365");
form.append("sido_nm", "경기도");
form.append("sgg_nm", "성남시 분당구");
form.append("emd_nm", "정자동");
form.append("bobn", "1");
form.append("bubn", "1");
const response = await fetch("https://apick.app/rest/iros_monitor", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("target_type", (None, "realestate")),
    ("duration_days", (None, "365")),
    ("sido_nm", (None, "경기도")),
    ("sgg_nm", (None, "성남시 분당구")),
    ("emd_nm", (None, "정자동")),
    ("bobn", (None, "1")),
    ("bubn", (None, "1")),
]
response = requests.request("POST", "https://apick.app/rest/iros_monitor",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'target_type' => 'realestate',
    'duration_days' => '365',
    'sido_nm' => '경기도',
    'sgg_nm' => '성남시 분당구',
    'emd_nm' => '정자동',
    'bobn' => '1',
    'bubn' => '1',
];
$curl = curl_init('https://apick.app/rest/iros_monitor');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## POST /rest/iros_monitor/status 응답 필드

## API 요청: POST /rest/iros_monitor/status



### 입력

- `target_type` (string, 필수): 대상 유형입니다. realestate(부동산) | corporation(법인).

- `duration_days` (number, 선택): 변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.

- `sido_nm` (string, 조건부): 부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `sgg_nm` (string, 조건부): 부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `emd_nm` (string, 조건부): 부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `ri_nm` (string, 선택): 리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 조건부): 부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bubn` (string, 선택): 부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `corp_name` (string, 조건부): 법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.

- `corp_reg_no` (string, 조건부): 법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).

- `idempotency_key` (string, 선택): 같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/iros_monitor/status' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "target_type=${APICK_TARGET_TYPE}"

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("target_type", process.env.APICK_TARGET_TYPE);
const response = await fetch("https://apick.app/rest/iros_monitor/status", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("target_type", (None, os.environ["APICK_TARGET_TYPE"])),
]
response = requests.request("POST", "https://apick.app/rest/iros_monitor/status",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'target_type' => getenv('APICK_TARGET_TYPE'),
];
$curl = curl_init('https://apick.app/rest/iros_monitor/status');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## POST /rest/iros_monitor/changed 응답 필드

## API 요청: POST /rest/iros_monitor/changed



### 입력

- `target_type` (string, 필수): 대상 유형입니다. realestate(부동산) | corporation(법인).

- `duration_days` (number, 선택): 변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.

- `sido_nm` (string, 조건부): 부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `sgg_nm` (string, 조건부): 부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `emd_nm` (string, 조건부): 부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `ri_nm` (string, 선택): 리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 조건부): 부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bubn` (string, 선택): 부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `corp_name` (string, 조건부): 법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.

- `corp_reg_no` (string, 조건부): 법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).

- `idempotency_key` (string, 선택): 같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/iros_monitor/changed' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "target_type=${APICK_TARGET_TYPE}"

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("target_type", process.env.APICK_TARGET_TYPE);
const response = await fetch("https://apick.app/rest/iros_monitor/changed", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("target_type", (None, os.environ["APICK_TARGET_TYPE"])),
]
response = requests.request("POST", "https://apick.app/rest/iros_monitor/changed",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'target_type' => getenv('APICK_TARGET_TYPE'),
];
$curl = curl_init('https://apick.app/rest/iros_monitor/changed');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## POST /rest/iros_monitor/list 응답 필드

## API 요청: POST /rest/iros_monitor/list



### 입력

- `target_type` (string, 필수): 대상 유형입니다. realestate(부동산) | corporation(법인).

- `duration_days` (number, 선택): 변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.

- `sido_nm` (string, 조건부): 부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `sgg_nm` (string, 조건부): 부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `emd_nm` (string, 조건부): 부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `ri_nm` (string, 선택): 리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 조건부): 부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bubn` (string, 선택): 부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `corp_name` (string, 조건부): 법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.

- `corp_reg_no` (string, 조건부): 법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).

- `idempotency_key` (string, 선택): 같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/iros_monitor/list' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "target_type=${APICK_TARGET_TYPE}"

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("target_type", process.env.APICK_TARGET_TYPE);
const response = await fetch("https://apick.app/rest/iros_monitor/list", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("target_type", (None, os.environ["APICK_TARGET_TYPE"])),
]
response = requests.request("POST", "https://apick.app/rest/iros_monitor/list",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'target_type' => getenv('APICK_TARGET_TYPE'),
];
$curl = curl_init('https://apick.app/rest/iros_monitor/list');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## POST /rest/iros_monitor/terminate 응답 필드

## API 요청: POST /rest/iros_monitor/terminate



### 입력

- `target_type` (string, 필수): 대상 유형입니다. realestate(부동산) | corporation(법인).

- `duration_days` (number, 선택): 변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.

- `sido_nm` (string, 조건부): 부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `sgg_nm` (string, 조건부): 부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `emd_nm` (string, 조건부): 부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `ri_nm` (string, 선택): 리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 조건부): 부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bubn` (string, 선택): 부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `corp_name` (string, 조건부): 법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.

- `corp_reg_no` (string, 조건부): 법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).

- `idempotency_key` (string, 선택): 같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/iros_monitor/terminate' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "target_type=${APICK_TARGET_TYPE}"

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("target_type", process.env.APICK_TARGET_TYPE);
const response = await fetch("https://apick.app/rest/iros_monitor/terminate", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("target_type", (None, os.environ["APICK_TARGET_TYPE"])),
]
response = requests.request("POST", "https://apick.app/rest/iros_monitor/terminate",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'target_type' => getenv('APICK_TARGET_TYPE'),
];
$curl = curl_init('https://apick.app/rest/iros_monitor/terminate');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요.

```json

{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}

```

## 상세 기능·요금

지원 API 요약 모니터링할 대상 등록과 대상별 상태 조회, 변동 감지 대상 묶음 조회, 전체 목록(무료), 모니터링 종료(무료) API로 나뉩니다. 등록 직후 1회 변동 검사를 바로 수행해 최초 기록을 남기고(status: "monitoring"), 이후 매일 1회씩 자동으로 변동 여부를 확인합니다. 변동이 감지되면 감지된 내용을 저장하고 상태를 changed로 바꿔 모니터링을 끝냅니다(그 이후로는 추가 과금이 없습니다). MethodAPI entry point기능성공 결과 POST/rest/iros_monitor대상 등록(50P, 기준 확인 1회 포함)target_id·status: "monitoring" POST/rest/iros_monitor/status대상 1건 상태·변동 조회(10P)status·변동 시 changed POST/rest/iros_monitor/changed변동 감지된 대상 묶음 조회(20P/건)targets 목록 POST/rest/iros_monitor/list내 전체 대상 목록(무료)targets 목록(변동 정보 없음) POST/rest/iros_monitor/terminate모니터링 종료(무료, 재시작 불가)status: "terminated" 변동 감지 대상 묶음 조회 본인이 등록한 모니터링 대상 중 변동이 감지된 것만 모아서 돌려줍니다(건당 20P). 변동이 감지된 대상이 없으면 과금 없이 빈 목록이 옵니다. form-data 전체 예제 보기 과금·환급 항목설명 대상 등록건당 50P입니다. 등록 즉시 수행하는 기준 확인 1회가 포함됩니다. 매일 자동 확인모니터링 중인 대상은 매일 1회 변동 여부를 확인하며 확인당 50P입니다. 변동 감지 시감지된 내용을 저장하고 상태를 changed로 바꿔 모니터링을 끝냅니다. 그 확인까지만 과금되고 이후로는 추가 과금이 없습니다. 대상별 상태 조회건당 10P입니다. 변동 감지 대상 묶음 조회건당 20P입니다. 변동 감지 대상이 없으면 과금하지 않습니다. 전체 목록 · 종료무료(0P)입니다. 확인 실패매일 확인이 일시적으로 실패하면 그 확인은 과금하지 않고 다음에 다시 확인합니다. 모니터링은 계속됩니다.

## 상세 요청

대상 등록 요청 form-data 전체 예제 보기 등록에 성공하면 target_id가 발급되고, 등록 즉시 1회 변동 검사를 수행해 최초 기록을 남깁니다(50P). 이 기준 기록과 비교해 매일 1회씩 새로 접수된 사건이나 진행 상태 변화가 있는지 확인합니다. 전체 목록 · 종료 요청 form-data 전체 예제 보기 종료(terminated)되거나 변동이 감지(changed)되거나 기간이 지나(expired) 모니터링이 끝난 대상은 다시 시작할 수 없습니다. 다시 모니터링하려면 대상 등록 API로 새로 등록해 주세요.

## 상세 응답

상황응답 등록 성공data.target_id·data.status: "monitoring"·data.duration_days 모니터링 중data.status: "monitoring", check_count·last_check_at·next_check_at로 확인 횟수와 다음 확인 시각을 알 수 있습니다. 변동 감지data.status: "changed", data.changed(감지 시각·새로 접수된 사건·진행 상태 변화)·data.changed_at 종료data.status: "terminated"·data.terminated_at 기간 만료data.status: "expired"

## 상세 코드·정책

대상별 상태 조회 요청 파라미터타입필수설명 target_idstring필수등록 응답으로 받은 대상 ID입니다. form-data 전체 예제 보기 오류 오류는 data.error(안내 문구)와 data.error_code로 옵니다. error_code의미대처 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일시적으로 처리할 수 없습니다.잠시 후 다시 시도합니다.
