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

# 소개

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <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에 포함된 Spaces 엔드포인트에 대해 설명합니다. Spaces 전반에 대해 더 알아보려면 [help.x.com](https://help.x.com/en/using-twitter/spaces)을 방문하세요. 

Spaces는 라이브 오디오 대화를 통해 표현과 상호작용을 가능하게 합니다. Spaces 엔드포인트는 Spaces 관련 새로운 기능을 만들 수 있는 도구를 제공합니다. 이 엔드포인트들을 사용해 라이브 또는 예약된 Spaces를 조회하거나, 사용자가 관심을 가질 만한 Spaces를 찾을 수 있도록 돕는 발견(discovery) 경험을 구축할 수 있습니다.

여러분이 창의성을 발휘해 우리가 설계한 방식을 넘어 Spaces를 확장해 보시기를 권장합니다. 이러한 엔드포인트를 사용하면 `title`에 포함된 키워드를 기반으로 청취자에게 Spaces를 추천하는 경험을 만들거나, 특정 사용자가 팔로우하는 계정 중 라이브 또는 예정된 Spaces를 호스팅하는 계정을 노출하는 경험을 구축할 수 있습니다. 또한 호스트가 자신의 Spaces 성과를 더 잘 이해하고 청중에 대한 인사이트를 더 많이 얻을 수 있도록 도울 수 있습니다.

<div id="important-resources">
  ### 중요 리소스
</div>

다음 리소스는 시작할 때와 Spaces 엔드포인트를 통합할 때 도움이 됩니다:

* [X API v2 액세스 권한 얻기](/ko/x-api/getting-started/getting-access)
* [Spaces 데이터 사전](/ko/x-api/fundamentals/data-dictionary#space)
* [Spaces 엔드포인트에 첫 요청 보내기](/ko/x-api/spaces/lookup/introduction)

   

<div id="whats-currently-available">
  #### 현재 사용 가능한 기능
</div>

|               |                                                                                                                                                                                                                                                                                                                                        |
| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Spaces 조회** | [단일 Spaces ID로 조회](/ko/x-api/spaces/space-lookup-by-space-id)<br /><br />[여러 Spaces ID로 조회](/ko/x-api/spaces/space-lookup-up-space-ids)<br /><br />[생성자 ID로 조회](/ko/x-api/spaces/space-lookup-by-their-creators)<br /><br />[티켓을 구매한 사용자 목록 조회](/ko/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space) |
| **Spaces 검색** | [키워드로 Spaces 검색](/ko/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                   |

<div id="understanding-the-lifecycle-of-spaces">
  #### Spaces의 수명 주기 이해하기
</div>

X Developer Platform의 다른 리소스와 달리, Spaces에는 정해진 수명 주기가 있습니다. Spaces는 시작 예정일로부터 최대 14일 전에 예약할 수 있으며, 종료되면 더 이상 이용할 수 없습니다. 호스트는 시작 전에 언제든지 미리 예약한 Space를 취소할 수 있습니다.

Spaces가 라이브 상태인 동안에는 액세스할 수 있지만, 종료되면 더 이상 Spaces 엔드포인트를 사용해 조회할 수 없으며, 이 상태를 나타내는 오류 메시지가 반환됩니다.

App이 Spaces 데이터를 처리할 때에는 가장 최신 정보를 반환하며, 플랫폼에서 더 이상 사용 불가능한 데이터는 제거할 책임이 있습니다. [Spaces lookup endpoint](/ko/x-api/spaces/lookup/introduction)를 사용하면 사용자의 기대와 의도에 부합하는지 확인하는 데 도움이 됩니다.
 

<div id="roles-in-spaces">
  ### Spaces에서의 역할
</div>

이 엔드포인트는 X 앱에서 Spaces가 동작하는 방식을 반영합니다. Spaces에서 X 사용자에게는 Space에 참여하고 상호 작용하는 방식에 따라 서로 다른 역할이 부여됩니다.
 

<div id="creator-or-primary-host">
  ### 생성자(또는 기본 호스트)
</div>

기본 호스트는 Space를 생성한 사용자이자 해당 Space의 소유자입니다. 현재 Space에는 하나의 호스트만 설정할 수 있으므로, 기본 호스트가 유일한 호스트입니다. [Spaces 데이터 사전](/ko/x-api/fundamentals/data-dictionary#space)에서는 기본 호스트 정보가 `creator_id` 필드에 저장되며, 이 필드를 확장하면 [user object](/ko/x-api/fundamentals/data-dictionary#user)로 가져올 수 있습니다.
 

<div id="hosts">
  ### 호스트
</div>

주 호스트는 하나 이상의 사용자를 공동 호스트로 지정할 수 있습니다. Spaces 데이터 사전에서 이러한 호스트는 `host_ids`로 표시되며, 사용자 객체 리스트로 확장할 수 있습니다. Space 진행 중에는 호스트 지정이 변경될 수 있으며, 이 엔드포인트에서 반환하는 메타데이터는 요청 시점의 상태를 반영합니다.

앱은 `creator_id` 값을 확인하여 주 호스트를 식별하고, `host_ids` 값을 확인하여 공동 호스트가 누구인지 알 수 있습니다.
 

<div id="speaker">
  ### 스피커
</div>

스피커는 Space에서 발언할 수 있는 권한을 가진 사용자입니다. 언제든지 0명 이상의 사용자가 스피커로 참여할 수 있으며, 하나의 Space에는 최대 10명의 스피커(Host 포함)까지 있을 수 있습니다. Space 데이터 딕셔너리에서는 스피커가 `speaker_ids` 리스트로 반환되며, 이를 확장해 사용자 객체 리스트로 변환할 수 있습니다.
 

<div id="listener">
  ### 리스너
</div>

리스너는 Space를 청취할 수 있고, 미리 정의된 반응을 사용해 언제든지 반응할 수 있으며, Host가 Space 설정에서 이를 허용한 경우 스피커가 되도록 요청할 수도 있습니다. 리스너 정보는 participant\_count 필드에서 Host를 포함한 참여자의 집계된 총계로만 반환됩니다.