소개

다음 페이지에서는 X API에 포함된 Spaces 엔드포인트에 대해 설명합니다. Spaces 전반에 대해 더 알아보려면 help.x.com을 방문하세요. 

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

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

​

중요 리소스

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

• X API v2 액세스 권한 얻기

• Spaces 데이터 사전

• Spaces 엔드포인트에 첫 요청 보내기

   

​

현재 사용 가능한 기능

Spaces 조회	단일 Spaces ID로 조회 여러 Spaces ID로 조회 생성자 ID로 조회 티켓을 구매한 사용자 목록 조회
Spaces 검색	키워드로 Spaces 검색

​

Spaces의 수명 주기 이해하기

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

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

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

​

Spaces에서의 역할

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

​

생성자(또는 기본 호스트)

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

​

호스트

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

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

​

스피커

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

​

리스너

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