중요 리소스
현재 제공되는 기능
| Spaces 조회 | 단일 Spaces ID로 조회 여러 Spaces ID로 조회 생성자 ID로 조회 티켓 구매 사용자 목록 조회 |
| Spaces 검색 | 키워드로 Spaces 검색 |
스페이스
소개
다음 페이지에서는 X API에 포함된 Spaces 엔드포인트를 설명합니다. Spaces 전반에 대해 더 알아보려면 help.x.com을 방문하세요.
Spaces는 라이브 오디오 대화를 통해 표현과 상호작용을 가능하게 합니다. Spaces 엔드포인트는 Spaces와 관련한 새로운 기능을 구축할 수 있는 도구를 제공합니다. 이 엔드포인트를 사용해 라이브 또는 예정된 Spaces를 조회하거나, 사용자가 관심을 가질 만한 Spaces를 찾을 수 있도록 탐색·발견 경험을 구축할 수 있습니다.
여러분의 창의성을 발휘해 우리가 제공한 방식 그 이상으로 Spaces를 확장해 보시기 바랍니다. 이러한 엔드포인트를 사용하면 제목에 포함된 키워드를 바탕으로 청취자에게 Spaces를 추천하는 경험을 만들거나, 사용자가 팔로우하는 계정 중 라이브 중이거나 곧 진행될 Spaces를 호스팅하는 계정을 노출할 수 있습니다. 또한 호스트가 자신의 Spaces 성과를 더 잘 이해하고 청중에 대한 인사이트를 얻도록 도울 수도 있습니다.
다음 리소스는 시작하고 Spaces 엔드포인트를 통합하는 데 도움이 됩니다:
X Developer Platform의 다른 리소스와 달리 Spaces에는 정해진 라이프사이클이 있습니다. Spaces는 예정된 시작일 기준 최대 14일 전에 예약할 수 있으며, 종료되면 더 이상 이용할 수 없습니다. 호스트는 시작되기 전이라면 언제든지 예약된 Space를 취소할 수 있습니다.
Spaces는 라이브 중에만 접근할 수 있습니다. 종료되면 Spaces 엔드포인트를 통해 더 이상 조회할 수 없으며, 이를 나타내는 오류 메시지가 반환됩니다.
앱이 Spaces 데이터를 처리할 때는 최신 정보를 반환하고, 플랫폼에서 더 이상 제공되지 않는 데이터를 제거할 책임이 있습니다. Spaces lookup 엔드포인트를 사용하면 사용자의 기대와 의도를 충족하도록 보장하는 데 도움이 됩니다.
이 엔드포인트는 X 앱에서 Spaces가 동작하는 방식을 반영합니다. Spaces에서 X 사용자는 Space와의 상호작용 방식과 Space 내 활동에 따라 특정 역할을 가질 수 있습니다.
기본 호스트는 Space를 만든 사용자이자 해당 Space의 소유자입니다. 현재 Space에는 호스트가 하나만 있을 수 있으므로 기본 호스트가 곧 유일한 호스트입니다. Spaces 데이터 사전에서 기본 호스트 정보는 creator_id 필드에 있으며, user 객체로 확장할 수 있습니다.
기본 호스트는 한 명 이상의 사용자를 공동 호스트로 지정할 수 있습니다. Spaces 데이터 사전에서 이러한 호스트는 host_ids로 표시되며, 사용자 객체 목록으로 확장할 수 있습니다. 호스트 지정은 Space 진행 중에 변경될 수 있으며, 해당 엔드포인트가 반환하는 메타데이터는 요청 시점의 상태를 반영합니다.
앱은 creator_id 값을 확인해 기본 호스트를 식별하고, host_ids 값을 확인해 공동 호스트가 누구인지 파악할 수 있습니다.
발표자는 Space에서 발언할 권한이 있는 사용자입니다. 언제든지 0명 이상이 있을 수 있으며, 하나의 Space에는 최대 10명의 발표자(Host 포함)가 있을 수 있습니다. Space 데이터 사전에서 발표자는 speaker_ids 목록으로 반환되며, 이를 확장해 사용자 객체 목록으로 만들 수 있습니다.
리스너는 Space를 청취하고 미리 정의된 리액션으로 언제든 반응할 수 있으며, 스피커가 되도록 요청할 수 있습니다(호스트가 Space 설정에서 이를 허용한 경우). 리스너 정보는 participant_count 필드에서 참가자(호스트 포함)의 집계 수로만 반환됩니다.