> ## 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의 Volume streams (1% 샘플 및 Decahose)

> X API v2의 1% sampled stream 및 10% Decahose volume stream 엔드포인트로 실시간 샘플 게시물을 스트리밍하여 트렌드, 감성, 이벤트를 추적하세요.

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>;
};

* 1% sampled stream.
* 10% sampled stream. 일반적으로 "Decahose"라고 합니다.

이들은 모두 대용량 데이터를 전달하기 때문에 "volume streams"라고 합니다. 1% stream만 해도 초당 수십 개의 게시물을 전송할 수 있습니다. 이 스트림을 사용하면 트렌드를 식별하고 추적하며, 일반 감성을 모니터링하고, 글로벌 이벤트를 모니터링하는 등 다양한 작업을 할 수 있습니다.

이 스트리밍 엔드포인트는 지속적인 HTTP GET 연결을 통해 [Post 객체](/x-api/fundamentals/data-dictionary/reference#tweet)를 전달하며, [OAuth 2.0 App-Only](/resources/fundamentals/authentication#oauth-2-0) 인증을 사용합니다. Essential access에서는 한 번에 하나의 연결을 사용할 수 있습니다. 모든 액세스 수준에서 연결 요청은 15분 창당 최대 50회까지 가능합니다.

이러한 volume stream 엔드포인트는 편집된 게시물을 지원합니다. 이 엔드포인트는 편집된 게시물을 편집 히스토리(Post ID 배열 포함)와 함께 전달합니다. 편집 히스토리가 없는 게시물의 경우 이 배열은 하나의 ID만 포함합니다. 편집된 게시물의 경우 이 배열은 편집 순서를 반영하는 오름차순으로 여러 ID를 포함하며, 가장 최근 버전이 배열의 마지막 위치에 있습니다. 게시물 편집 동작 방식에 대해 자세히 알아보려면 [Post edits 기본](/x-api/fundamentals/edit-posts) 페이지를 참조하세요.

*이 API를 사용하려면 먼저 저희 enterprise sales 팀에 계정을 설정해야 합니다.*

<Note>
  **계정 설정**

  이 엔드포인트에 접근하려면 다음이 필요합니다:

  * 승인된 [developer account](https://developer.x.com/en/portal/petition/essential/basic-info).
  * [Project](/resources/fundamentals/developer-apps) 내에 위치한 [developer App](/resources/fundamentals/developer-apps)의 keys and tokens로 인증.

  X API v2 엔드포인트 접근에 대한 자세한 내용은 [시작하기 가이드](/x-api/getting-started/getting-access)를 참고하세요.
</Note>

<div class="flex space-x-2">
  <Button href="/x-api/posts/volume-streams/quickstart">
    퀵스타트
  </Button>

  <Button href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    샘플 코드
  </Button>

  <Button href="https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80">
    Postman에서 실행
  </Button>

  <Button href="https://developer.x.com/apitools/api?endpoint=/2/tweets/sample/stream&method=get">
    API Explorer로 시도하기
  </Button>
</div>

***

## 스트리밍 기본 개념

<CardGroup cols={2}>
  <Card title="스트리밍 데이터 소비" icon="stream" href="/x-api/fundamentals/consuming-streaming-data">
    스트리밍 클라이언트를 위한 모범 사례
  </Card>

  <Card title="연결 끊김 처리" icon="plug" href="/x-api/fundamentals/handling-disconnections">
    원활하게 재연결하기
  </Card>

  <Card title="대용량 처리 능력" icon="gauge-high" href="/x-api/fundamentals/high-volume-capacity">
    높은 처리량 처리
  </Card>

  <Card title="복구 및 이중화" icon="https://mintcdn.com/x-preview/cfyQtgCdwk8p69aa/icons/xds/icon-shield-keyhole.svg?fit=max&auto=format&n=cfyQtgCdwk8p69aa&q=85&s=a0e05514090c8a6af232297bfb9c4055" href="/x-api/fundamentals/recovery-and-redundancy" width="24" height="24" data-path="icons/xds/icon-shield-keyhole.svg">
    복원력 있는 애플리케이션 구축
  </Card>
</CardGroup>