Skip to main content
La siguiente página describe los endpoints de Spaces incluidos en la X API. Para saber más sobre Spaces en general, visita help.x.com. Spaces permiten la expresión e interacción a través de conversaciones de audio en vivo. Los endpoints de Spaces proporcionan las herramientas para crear nuevas funcionalidades en torno a Spaces. Puedes usar estos endpoints para buscar Spaces en vivo o programados, o para construir experiencias de descubrimiento que ofrezcan a tus usuarios formas de encontrar Spaces que les puedan interesar. Te animamos a usar tu creatividad para extender Spaces más allá de la forma en que lo construimos. Con estos endpoints puedes construir experiencias para sugerir Spaces a los oyentes según las palabras clave presentes en el título, o mostrando cuentas que son host de Spaces en vivo o próximos y a las que sigue un usuario; también puedes ayudar a los Hosts a comprender mejor cómo se desempeñan sus Spaces y obtener más información sobre su audiencia.

​
Recursos importantes

Los siguientes recursos te ayudarán a comenzar e integrarte con los endpoints de Spaces:

​
Qué está disponible actualmente

​
Comprender el ciclo de vida de Spaces

A diferencia de otros recursos de la X Developer Platform, Spaces tiene un ciclo de vida definido. Los Spaces pueden programarse hasta 14 días antes de su fecha de inicio prevista y quedan indisponibles después de finalizar. Un host también puede cancelar un Space previamente programado en cualquier momento antes de su inicio. Los Spaces son accesibles mientras están en vivo; una vez finalizados, ya no estarán disponibles para su recuperación mediante los endpoints de Spaces, y se devolverá un mensaje de error para indicar esta condición. Cuando tu app maneje datos de Spaces, eres responsable de devolver la información más actualizada y de eliminar los datos que ya no estén disponibles en la plataforma. El endpoint de búsqueda de Spaces puede ayudarte a garantizar que respetas las expectativas e intenciones de tus usuarios.

​
Roles en Spaces

Estos endpoints reflejan la forma en que Spaces funciona en la app X. En Spaces, los usuarios de X pueden tener roles definidos según cómo interactúen con y dentro de un Space.

​
Creator (u host principal)

El Host principal es el usuario que creó un Space y el propietario del Space en sí. Actualmente, los Spaces solo pueden tener un Host, por lo que el Host principal será el único Host. En el diccionario de datos de Spaces, la información del Host principal estará en el campo creator_id, que puede expandirse a un objeto user.

​
Hosts

Los Hosts principales pueden convertir a uno o más usuarios en co-hosts. En el diccionario de datos de Spaces, estos Hosts aparecerán como host_ids, que puede expandirse a una lista de objetos user. La designación de Host puede cambiar a lo largo de la duración de un Space, y los metadatos devueltos por estos endpoints reflejarán el estado al momento de la solicitud. Tu app conocerá el host principal comprobando el valor de creator_id, y quiénes son los co-hosts comprobando los valores de host_ids.

​
Speaker

Los Speakers son usuarios que tienen permiso para hablar en el Space. Puede haber cero o más Speakers en cualquier momento, y puede haber hasta 10 Speakers (incluidos los Hosts) en un Space. En el diccionario de datos de Space, los speakers se devolverán en la lista speaker_ids, que puedes expandir a una lista de objetos user.

​
Listener

Un Listener puede escuchar un Space, reaccionar en cualquier momento usando las reacciones predefinidas y solicitar convertirse en speaker (cuando los Hosts lo permiten en la configuración del Space). La información del Listener solo se devolverá como un conteo agregado de participantes (incluidos los Hosts) en el campo participant_count.