Skip to main content
다음 페이지는 X API에 포함된 Spaces 엔드포인트를 설명합니다. Spaces 전반에 대해 자세히 알아보려면 help.x.com을 방문하세요. Spaces는 실시간 오디오 대화를 통한 표현과 상호작용을 가능하게 합니다. Spaces 엔드포인트는 Spaces를 중심으로 새로운 기능을 만들 수 있는 도구를 제공합니다. 이 엔드포인트를 사용하여 라이브 또는 예약된 Spaces를 조회하거나, 사용자가 관심을 가질만한 Spaces를 찾을 수 있는 발견 경험을 구축할 수 있습니다. 여러분의 창의력을 발휘하여 우리가 만든 방식 이상으로 Spaces를 확장해 보시길 권장합니다. 이러한 엔드포인트를 사용하여 제목의 키워드를 기반으로 청취자에게 Spaces를 추천하는 경험을 만들거나, 사용자가 팔로우하는 사람 중 라이브 또는 예정된 Spaces를 개최하는 계정을 노출시킬 수 있습니다. 또한 Host가 자신의 Spaces 성과를 더 잘 이해하고 청중에 대한 인사이트를 더 얻을 수 있도록 도울 수 있습니다.

​
중요한 리소스

다음 리소스는 Spaces 엔드포인트를 시작하고 통합하는 데 도움이 됩니다:

​
현재 사용 가능한 항목

​
Spaces의 라이프사이클 이해하기

X 개발자 플랫폼의 다른 리소스와 달리, Spaces는 정해진 라이프사이클을 가지고 있습니다. Spaces는 예정된 시작일로부터 최대 14일 전에 예약할 수 있으며, 종료된 후에는 사용할 수 없게 됩니다. Host는 또한 시작 전 언제든지 예약된 Space를 취소할 수 있습니다. Spaces는 라이브 중일 때 액세스 가능합니다. 종료된 후에는 Spaces 엔드포인트를 사용하여 조회할 수 없게 되며, 이 상태를 나타내는 오류 메시지가 반환됩니다. 앱이 Spaces 데이터를 처리할 때, 여러분은 최신 정보를 반환하고, 플랫폼에서 더 이상 사용할 수 없는 데이터를 제거해야 할 책임이 있습니다. Spaces 조회 엔드포인트는 사용자의 기대와 의도를 존중하도록 하는 데 도움이 될 수 있습니다.

​
Spaces의 역할

이 엔드포인트는 X 앱에서 Spaces가 작동하는 방식을 반영합니다. Spaces에서 X 사용자는 Space와 상호 작용하는 방식에 따라 정의된 역할을 가질 수 있습니다.

​
Creator (또는 주요 host)

주요 Host는 Space를 만든 사용자이며, Space 자체의 소유자입니다. 현재 Spaces는 하나의 Host만 가질 수 있으므로, 주요 Host가 유일한 Host입니다. Spaces 데이터 사전에서 주요 Host 정보는 creator_id 필드에 있으며, user 객체로 확장될 수 있습니다.

​
Hosts

주요 Host는 하나 이상의 사용자를 공동 host로 지정할 수 있습니다. Spaces 데이터 사전에서 이러한 Host는 host_ids로 나타나며, user 객체 목록으로 확장될 수 있습니다. Host 지정은 Space의 지속 시간 내내 변경될 수 있으며, 이 엔드포인트에서 반환된 메타데이터는 요청 시점의 상태를 반영합니다. 앱은 creator_id 값을 확인하여 주요 host를 알 수 있으며, host_ids 값을 확인하여 공동 host가 누구인지 알 수 있습니다.

​
Speaker

Speaker는 Space에서 말할 수 있는 권한을 가진 사용자입니다. 언제든지 0명 이상의 Speaker가 있을 수 있으며, Space에는 최대 10명의 Speaker(Host 포함)가 있을 수 있습니다. Space 데이터 사전에서 speaker는 speaker_ids 목록에서 반환되며, user 객체 목록으로 확장할 수 있습니다.

​
Listener

Listener는 Space를 듣고, 미리 정의된 반응을 사용하여 언제든지 반응할 수 있으며, speaker가 되도록 요청할 수 있습니다(Host가 Space 설정에서 이를 허용하는 경우). Listener 정보는 participant_count 필드에서 참여자(Host 포함)의 집계 카운트로만 반환됩니다.