Recursos importantes
- Como obter acesso à X API v2
- Dicionário de dados de Spaces
- Faça sua primeira solicitação a um endpoint de Spaces
Spaces
Introdução
A página a seguir descreve os endpoints de Spaces incluídos na X API. Para saber mais sobre Spaces em geral, visite help.x.com.
Spaces permitem expressão e interação por meio de conversas de áudio ao vivo. Os endpoints de Spaces fornecem as ferramentas para criar novas funcionalidades relacionadas a Spaces. Você pode usar esses endpoints para consultar Spaces ao vivo ou agendados, ou para criar experiências de descoberta que ofereçam aos seus usuários maneiras de encontrar Spaces que possam interessar a eles.
Incentivamos você a usar sua criatividade para expandir Spaces além da forma como o concebemos. Com esses endpoints, você pode criar experiências para sugerir Spaces a ouvintes com base nas palavras-chave presentes no título ou destacando contas que hospedam Spaces ao vivo ou futuros e que são seguidas por um usuário; você também pode ajudar Hosts a entender melhor o desempenho de seus Spaces e obter mais insights sobre seu público.
Os recursos a seguir ajudarão você a começar e a se integrar aos endpoints de Spaces:
Diferentemente de outros recursos da X Developer Platform, Spaces têm um ciclo de vida definido. Spaces podem ser agendados com até 14 dias de antecedência da data prevista de início e ficam indisponíveis após o encerramento. Um host também pode cancelar um Space previamente agendado a qualquer momento antes de começar.
Spaces ficam acessíveis enquanto estão ao vivo; após o término, não estarão mais disponíveis para recuperação usando os endpoints de Spaces, e uma mensagem de erro será retornada para indicar essa condição.
Quando sua App lida com dados de Spaces, você é responsável por fornecer as informações mais atualizadas e remover os dados que não estão mais disponíveis na plataforma. O endpoint de consulta de Spaces pode ajudar você a garantir que respeita as expectativas e a intenção dos seus usuários.
Esses endpoints refletem como as Spaces funcionam no App X. Em Spaces, os users do X podem ter funções definidas dependendo de como interagem com um Space e dentro dele.
O anfitrião principal é o usuário que criou um Space e o proprietário do Space em si. Atualmente, os Spaces podem ter apenas um anfitrião; portanto, o anfitrião principal será o único anfitrião. No dicionário de dados de Spaces, as informações do anfitrião principal estarão no campo creator_id, que pode ser expandido para um objeto de usuário.
Os hosts principais podem tornar um ou mais usuários co-hosts. No dicionário de dados de Spaces, esses hosts aparecerão como host_ids, que podem ser expandidos em uma lista de objetos de usuário. A designação de host pode mudar ao longo da duração de um Space, e os metadados retornados por esses endpoints refletirão o status no momento da solicitação.
Seu App identificará o host principal verificando o valor de creator_id e os co-hosts verificando os valores de host_ids.
Speakers são usuários que têm permissão para falar em um Space. Zero ou mais Speakers podem estar presentes a qualquer momento, e pode haver até 10 Speakers (incluindo os Hosts) em um Space. No dicionário de dados do Space, os Speakers serão retornados na lista speaker_ids, que você pode expandir para uma lista de objetos de usuário.
Um Ouvinte pode ouvir um Space, reagir a qualquer momento usando as reações predefinidas e solicitar que se torne um speaker (quando os Hosts permitem isso nas configurações do Space). As informações do Ouvinte serão retornadas apenas como uma contagem agregada de participantes (incluindo Hosts) no campo participant_count.
⌘I