> ## 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 v2는 매우 중요합니다. 따라서 이 마이그레이션 섹션을 몇 가지 파트로 나누었습니다: X API v2는 이제 주요 X API입니다.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

최신 버전의 X API v2는 매우 중요합니다. 따라서 이 마이그레이션 섹션을 몇 가지 파트로 나누었습니다:

| X API v2의 새로운 점   | X API v2에 출시된 새로운 엔드포인트와 기능에 대해 알아보세요.                                 |
| :---------------- | :--------------------------------------------------------------------- |
| 마이그레이션 준비 됐나요?    | 일련의 가이드와 지침으로 마이그레이션을 시작하세요.                                           |
| 데이터 포맷 마이그레이션 가이드 | 기존 standard v1.1 및 enterprise 데이터 포맷과 호환되던 데이터 파서를 어떻게 재작업하는지 알아보세요.   |
| X API 엔드포인트 맵     | standard v1.1 및 enterprise 엔드포인트가 새로운 X API v2 엔드포인트에 어떻게 매핑되는지 확인하세요. |

***

## X API v2란 무엇인가요?

X API v2는 이제 주요 X API이며, 제품 투자와 혁신이 집중되는 곳입니다. 우리는 개발자들과 협력하여 다양한 개발자 커뮤니티를 더 잘 지원하기 위해 차세대 X API를 구축했습니다. 개발자 피드백을 바탕으로, 더 광범위한 요구사항에 부응하기 위해 API를 재구축하고, 새로운 기능과 엔드포인트를 도입했으며, 개발자 경험을 개선했습니다.

X API v2는 이제 주요 X API이며, 제품 투자와 혁신이 집중되는 곳입니다. 지난 몇 년간 우리는 개발자와 협력하여 더 폭넓은 요구를 지원하고 새로운 기능과 엔드포인트를 도입하며 개발자 경험을 개선하기 위해 API를 재구축했습니다. 우리는 개방적인 개발자 플랫폼 구축을 지속하기 위해 헌신하며, 여러분이 X API v2로 무엇을 만들어낼지 기대합니다.

## 왜 마이그레이션해야 하나요?

X API v2는 현대적이고 지속 가능한 기반 위에 구축되었으며, standard v1.1 및 enterprise 제품을 대체하는 개선된 엔드포인트뿐만 아니라, 완전히 새로운 기능도 포함합니다. 결국에는 레거시 API(v1.1 및 enterprise)를 사용 중단할 예정이므로, 레거시 API 고객은 v2로 마이그레이션하기 시작할 것을 강력히 권장합니다. X API를 사용해 공개적인 대화를 청취하고 분석하며, X에서 사람들과 소통하고, 혁신하세요.

이 섹션에서는 엔드포인트와 기능에 대해 논의합니다.

## V2 엔드포인트

다음 가이드를 통해 v2 엔드포인트의 전체 목록과 그에 상응하는 v2 이전 엔드포인트를 볼 수 있습니다:

<Button href="/x-api/migrate/x-api-endpoint-map">
  X API 엔드포인트 맵
</Button>

X API v2의 대부분의 엔드포인트는 대체용이지만, 몇 가지 새로운 엔드포인트를 도입했습니다. 다음은 v2에 출시된 새로운 엔드포인트의 몇 가지 예시입니다:

* 사람들이 X Spaces를 더 잘 활용하고, 개발자가 오디오 대화의 미래를 형성하는 데 도움이 되도록 [Spaces 엔드포인트](/x-api/spaces/introduction).
* 대규모로 학대적이거나 산만하거나 오해의 소지가 있는 답글의 영향을 제한하는 도구를 구축할 수 있는 [Hide replies](/x-api/posts/hide-replies/introduction).
* [List를 pin 및 unpin](/x-api/lists/pinned-lists/introduction)하거나 다른 사람의 pinned List를 조회할 수 있는 새로운 Lists 엔드포인트.
* 저장된 사용자 및 Tweet 데이터가 규정을 준수하는지 확인할 수 있는 새로운 [batch compliance 엔드포인트](/x-api/compliance/batch-compliance/introduction).

## 새로운 기능

X API v2에는 X API를 통해 더 많은 가치를 발견할 수 있도록 도와주는 새로운 기능도 포함되어 있습니다. 새로운 기능의 상당 부분은 여러분의 피드백에 의해 주도되었으며, 이전에는 enterprise 고객에게만 제공되었던 특정 기능도 포함되어 있습니다.

API에 대한 개선 사항은 다음과 같습니다:

* [엔드포인트 전반에 걸친 일관된 설계](/x-api/fundamentals/consistency)
* [응답 페이로드에 반환할 필드와 객체를 지정할 수 있는 기능](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions)
* [새롭고 더 상세한 데이터 객체](/x-api/fundamentals/data-dictionary)
* [Tweet annotations 기반의 새로운 컨텍스트 정보로 데이터 수신 및 필터링](/x-api/fundamentals/post-annotations)
* [새로운 메트릭에 대한 액세스](/x-api/fundamentals/metrics)
* [reply 스레드에 속하는 대화를 쉽게 식별하고 필터링](/x-api/fundamentals/conversation-id)
* [학술 연구자를 위한 고급 기능과 데이터 액세스 확대](https://developer.x.com/content/developer-twitter/en/products/twitter-api/academic-research)
* [스트리밍 엔드포인트를 위한 복구 및 이중화 기능](/x-api/fundamentals/recovery-and-redundancy)
* [쿼리와 일치하는 Tweet의 카운트를 손쉽게 반환](/x-api/posts/counts/introduction)
* [Edit Tweets 지원](/x-api/fundamentals/edit-posts)
* 높은 신뢰도의 스팸 필터링
* 더 효과적인 필터링 및 분석을 위해 단축 URL을 완전히 풀어냄
* 사용 중단된 필드를 제거하고 라벨을 현대화하여 단순화된 JSON 응답 객체
* 검색 쿼리에서 일치하는 공개 및 사용 가능한 Tweet의 100% 반환
* 연결을 끊지 않고 변경할 수 있는 스트리밍 "rules"
* Tweet 검색, Tweet counts, filtered stream에 대한 더욱 표현력 있는 쿼리 언어
* 새 라이브러리 구축 및 변경 사항을 더 투명하게 추적할 수 있는 OpenAPI 스펙

### 새롭고 업데이트된 응답 객체 살펴보기

v2 엔드포인트에서는 다음 6개의 데이터 객체를 사용할 수 있습니다:

| 객체                                                            | 설명                                                                                                                               |
| :------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------- |
| [Tweet](/x-api/fundamentals/data-dictionary/reference#tweet)  | Tweet 객체에는 `id`, `text`, `created_at` 같은 최상위 필드가 많이 있습니다. Tweet 객체는 또한 `user`, `media`, `poll`, `place`를 포함한 여러 자식 객체의 부모 객체입니다. |
| [User](/x-api/fundamentals/data-dictionary/reference#user)    | user 객체는 참조된 사용자를 설명하는 X 사용자 계정 메타데이터를 포함합니다.                                                                                    |
| [Spaces](/x-api/fundamentals/data-dictionary/reference#space) | Space 객체는 다음과 같은 필드로 구성됩니다.                                                                                                      |