> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 버전 관리

> X API 버전 관리 작동 방식, v1.1, v2, enterprise 간의 차이, 그리고 어떤 변경이 breaking 변경인지 additive 업데이트인지.

X API는 endpoint 경로에 버전 번호를 사용하여 진화를 허용하면서도 안정성을 제공합니다. 버전 관리 전략을 이해하면 통합을 계획하고 최신 상태를 유지하는 데 도움이 됩니다.

***

## 현재 버전

| 버전             | 상태    | 설명                            |
| :------------- | :---- | :---------------------------- |
| **v2**         | 현재    | 최신 endpoint, 유연한 가격, 모든 신규 기능 |
| **v1.1**       | 레거시   | 제한된 지원, 최소한의 업데이트             |
| **Enterprise** | 사용 가능 | 전용 지원과 함께 대용량 액세스             |

<Tip>
  모든 신규 프로젝트에는 **X API v2**를 사용하세요. 여기서 모든 새로운 기능이 출시됩니다.
</Tip>

***

## URL의 버전

버전 번호는 endpoint 경로에 나타납니다:

```
https://api.x.com/2/tweets
                   ^
                   version
```

***

## Breaking vs. non-breaking 변경

### Breaking 변경(코드 업데이트 필요)

이러한 변경은 주요 버전 업그레이드에서만 발생합니다:

* Endpoint 제거
* 응답 field 제거
* 쿼리 파라미터 제거
* 새로운 필수 파라미터 추가
* field의 데이터 유형 변경
* field 또는 리소스 이름 변경
* 응답 코드나 오류 유형 변경
* 인증 scope 수정

### Non-breaking 변경(추가)

버전 변경 없이 언제든지 발생할 수 있습니다:

* 새 endpoint 추가
* 새 선택적 파라미터 추가
* 새 응답 field 추가
* 새 OAuth scope 추가
* 오류 메시지 텍스트 변경
* 프라이버시/보안 이유로 field null 처리

***

## 릴리스 일정

| 유형                  | 빈도      | 공지              |
| :------------------ | :------ | :-------------- |
| **주요 버전**           | 연 1회 이하 | 마이그레이션 가이드 제공   |
| **Non-breaking 변경** | 지속적     | Changelog 업데이트  |
| **보안 패치**           | 필요 시    | 현재 버전에 적용될 수 있음 |

***

## 지원 중단 정책

새로운 주요 버전을 릴리스할 때:

1. **지원 중단**: 이전 버전이 지원 중단됨으로 표시됨
2. **지원 기간**: 지원 중단된 버전은 정의된 기간 동안 계속 작동
3. **은퇴**: 지원 중단된 버전이 제거됨

### 정의

| 상태        | 의미                             |
| :-------- | :----------------------------- |
| **활성**    | 새 기능과 수정으로 완전 지원               |
| **지원 중단** | 새 기능 없음, 중요 버그만 수정, 사용 권장하지 않음 |
| **은퇴**    | 더 이상 접근 불가                     |

***

## 정보 유지

변경 사항에 대한 알림 받기:

<CardGroup cols={2}>
  <Card title="Changelog" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-history.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=6afe17587c08ee621e37afde19a07ff1" href="/changelog" width="24" height="24" data-path="icons/xds/icon-history.svg">
    모든 플랫폼 변경 사항 및 업데이트.
  </Card>

  <Card title="포럼 공지" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    Breaking 변경 공지.
  </Card>

  <Card title="@XDevelopers" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-logo-x.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=53e3153f3b8d6efdad31484ef133b274" href="https://x.com/XDevelopers" width="24" height="24" data-path="icons/xds/icon-logo-x.svg">
    플랫폼 뉴스 및 업데이트.
  </Card>

  <Card title="뉴스레터" icon="https://mintcdn.com/x-preview/UIyI4eSwiP2OpODQ/icons/xds/icon-envelope.svg?fit=max&auto=format&n=UIyI4eSwiP2OpODQ&q=85&s=fbd38dbcd64d8688d3c9912ac30c4621" href="/newsletter" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    월간 다이제스트.
  </Card>
</CardGroup>

***

## 마이그레이션 리소스

새 버전이 릴리스되면 다음을 제공합니다:

* **마이그레이션 가이드**: 단계별 업그레이드 지침
* **Endpoint 매핑**: v1을 v2 대응으로
* **데이터 형식 변경**: 객체 모델 차이

<CardGroup cols={2}>
  <Card title="마이그레이션 개요" icon="route" href="/x-api/migrate/overview">
    현재 마이그레이션 가이드.
  </Card>

  <Card title="Endpoint 맵" icon="map" href="/x-api/migrate/x-api-endpoint-map">
    v1을 v2 endpoint 매핑.
  </Card>
</CardGroup>

***

## 모범 사례

<CardGroup cols={2}>
  <Card title="v2 사용" icon="arrow-up">
    최신 버전에서 새 프로젝트를 시작하세요.
  </Card>

  <Card title="공지 모니터링" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bell.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=5e0b3dcfbb39ba3d4619931d7cd927d1" width="24" height="24" data-path="icons/xds/icon-bell.svg">
    changelog 및 포럼 업데이트를 구독하세요.
  </Card>

  <Card title="변경 사항 테스트" icon="flask">
    프로덕션 업데이트 전에 개발 환경에서 테스트하세요.
  </Card>

  <Card title="마이그레이션 계획" icon="calendar">
    지원 중단까지 기다리지 말고 업그레이드하세요.
  </Card>
</CardGroup>