> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ko/docs/versioning

# 버전 관리와 지원 중단

API 버전은 경로에 포함됩니다. 예를 들어 /v1/status 입니다. 같은 버전 안에서는 기존 요청이 계속 작동합니다.

API 버전은 경로에 포함됩니다. 예를 들어 `/v1/status`입니다. 같은 버전 안에서는 기존 요청이 계속 작동합니다. 이 페이지에서는 무엇이 변경될 수 있는지, 얼마나 사전에 안내받는지, 업데이트가 필요한 요청을 어떻게 찾는지 설명합니다.

### 사전 안내 없는 변경

새 엔드포인트, 선택적 매개변수, 응답 필드, 기존 옵션 목록의 새 값, 응답 헤더, 오류 코드는 언제든 추가될 수 있습니다. 클라이언트는 알 수 없는 필드를 무시하고 새로운 값을 유연하게 처리하도록 작성하세요.

### 호환성을 깨는 변경

엔드포인트, 매개변수, 필드를 제거하거나 이름을 바꾸거나 의미를 변경하는 작업은 최소 12개월 전에 안내한 후에만 이루어집니다. 그 기간 동안 이전 형식은 계속 작동하고, 이를 사용하는 요청의 응답에는 `Deprecation` 및 `Sunset` 헤더가 포함되며, 해당 변경은 변경 로그에 기록됩니다.

### 응답 키 명명

대부분의 응답 키는 snake_case입니다. 모든 키를 snake_case로 받으려면 `naming=snake`를 추가하거나 `DomScan-Naming: snake` 헤더를 보내세요. 옵트인 방식이므로 기본 응답은 변경되지 않습니다. [snake_case 키](https://domscan.net/ko/docs/response-format#naming)를 참고하세요.

### 지원 중단된 별칭

다음 이전 매개변수는 아직 작동합니다. 각 매개변수는 최소한 종료일까지 계속 작동합니다. 그 전에 대체 항목으로 전환하세요.

| 매개변수 | 엔드포인트 | 대신 사용 | 지원 중단일 | 종료일 |
| --- | --- | --- | --- | --- |
| `prefer_cache` | `GET /v1/status` | `max_age=2592000` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/status` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `cache_skip` | `GET /v1/status` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `cache-skip` | `GET /v1/status` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `options.prefer_cache` (JSON 본문) | `POST /v1/status/bulk` | `max_age=2592000` | 2026-10-10 | 2027-10-10 |
| `prefer_cache` (JSON 본문) | `POST /v1/status/bulk` | `max_age=2592000` | 2026-10-10 | 2027-10-10 |
| `options.skip_cache` (JSON 본문) | `POST /v1/status/bulk` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `options.cache_skip` (JSON 본문) | `POST /v1/status/bulk` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `options.cache-skip` (JSON 본문) | `POST /v1/status/bulk` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `prefer_cache` | `GET /v1/subdomains` | `max_age=2592000` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/tech` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/categorize` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/identity-assets` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/identity-resolution` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/url-intelligence` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/agent-readiness` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `skip_cache` | `GET /v1/robots` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `refresh` | `GET /v1/ssl/deep-scan` | `max_age=0` | 2026-10-10 | 2027-10-10 |
| `cursor` (숫자 값) | `GET /v1/certificates` | `cursor=<next_cursor>` | 2026-10-10 | 2027-10-10 |
| `offset` | `GET /v1/email/blacklist` | `cursor=<next_cursor>` | 2026-10-10 | 2027-10-10 |

### 지원 중단 감지

지원 중단된 별칭을 사용하는 요청은 다음 응답 헤더를 받습니다. 응답 본문은 동일하게 유지됩니다.

- `Deprecation`: 별칭이 지원 중단된 날짜로, `@` 뒤에 Unix 초를 붙인 형식입니다 (RFC 9745).

- `Sunset`: 별칭이 작동을 멈출 수 있는 가장 이른 날짜입니다 (RFC 8594).

- `Link`: `rel="deprecation"`이 포함된 이 페이지로의 링크입니다.

```bash
curl -i -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/status?name=example&tlds=com&skip_cache=true"

Deprecation: @1791590400
Sunset: Sun, 10 Oct 2027 00:00:00 GMT
Link: <https://domscan.net/docs/versioning#deprecated-aliases>; rel="deprecation"; type="text/html"
```

브라우저는 세 헤더를 모두 읽을 수 있습니다. 종료일 전에 업데이트가 필요한 코드를 찾으려면 `Deprecation`을 로그로 남기거나 알림을 설정하세요.

모든 지원 중단은 [API 변경 로그](https://domscan.net/ko/changelog)에도 공지됩니다.