Recursos importantes
- Obtener acceso a X API v2
- Diccionario de datos de Spaces
- Realiza tu primera solicitud a un endpoint de Spaces
Espacios
Introducción
La siguiente página describe los endpoints de Spaces incluidos en la X API. Para obtener más información sobre Spaces en general, visita help.x.com.
Spaces permite expresarse e interactuar mediante conversaciones de audio en vivo. Los endpoints de Spaces proporcionan herramientas para crear nuevas funcionalidades en torno a Spaces. Puedes usar estos endpoints para consultar Spaces en vivo o programados, o para crear experiencias de descubrimiento que ofrezcan a tus usuarios formas de encontrar Spaces que puedan interesarles.
Te animamos a usar tu creatividad para ampliar Spaces más allá de cómo lo concebimos. Con estos endpoints puedes crear experiencias para sugerir Spaces a los oyentes en función de las palabras clave presentes en el título, o destacar cuentas que organicen Spaces en vivo o próximos y que sean seguidas por un usuario; también puedes ayudar a los anfitriones a entender mejor el rendimiento de sus Spaces y obtener más información sobre su audiencia.
Los siguientes recursos te ayudarán a comenzar e integrarte con los endpoints de Spaces:
A diferencia de otros recursos de la X Developer Platform, Spaces tienen un ciclo de vida definido. Se pueden programar hasta 14 días antes de su fecha de inicio prevista y dejan de estar disponibles después de finalizar. Un anfitrión también puede cancelar un Space programado en cualquier momento antes de que comience.
Los Spaces son accesibles mientras están en directo; una vez que finalizan, ya no estarán disponibles para su obtención mediante los endpoints de Spaces y se devolverá un mensaje de error que indique esta condición.
Cuando tu App gestione datos de Spaces, eres responsable de proporcionar 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 intención de tus usuarios.
Estos endpoints reflejan cómo funcionan los Spaces en la App de X. En Spaces, los usuarios de X pueden tener roles definidos según cómo interactúan con y dentro de un Space.
El anfitrión principal es el usuario que creó un Space y el propietario del Space. Actualmente, los Spaces solo pueden tener un anfitrión, por lo que el anfitrión principal será el único anfitrión. En el diccionario de datos de Spaces, la información del anfitrión principal estará en el campo creator_id, que se puede expandir a un objeto de usuario.
Los anfitriones principales pueden convertir a uno o más usuarios en coanfitriones. En el diccionario de datos de Spaces, estos anfitriones aparecerán como host_ids, que se pueden expandir en una lista de objetos de usuario. La designación de anfitrión puede cambiar durante la duración de un Space, y los metadatos devueltos por estos endpoints reflejarán el estado en el momento de la solicitud.
Tu App identificará al anfitrión principal al comprobar el valor de creator_id, y a los coanfitriones al comprobar los valores de host_ids.
Los oradores son usuarios que tienen permiso para hablar en el Space. Puede haber cero o más oradores en cualquier momento, y puede haber hasta 10 oradores (incluidos los Hosts) en un Space. En el diccionario de data del Space, los oradores se devolverán en la lista speaker_ids, que puedes expandir en una lista de objetos de usuario.
Un oyente puede escuchar un Space, reaccionar en cualquier momento con las reacciones predefinidas y solicitar convertirse en orador (cuando los Hosts lo permiten en la configuración del Space). La información de los oyentes solo se devolverá como un conteo agregado de participantes (incluidos los Hosts) en el campo participant_count.