Recursos importantes
- Obtener acceso a X API v2
- Diccionario de datos de Spaces
- Haz tu primera solicitud a un endpoint de Spaces
Spaces
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 la expresión y la interacción mediante conversaciones de audio en vivo. Los endpoints de Spaces proporcionan las herramientas para crear nueva funcionalidad en torno a Spaces. Puedes usar estos endpoints para buscar Spaces en vivo o programados, o para crear experiencias de descubrimiento que ayuden a tus usuarios a encontrar Spaces que puedan interesarles.
Te animamos a usar tu creatividad para ampliar Spaces más allá de cómo lo hemos diseñado. 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 mostrando cuentas que alojan Spaces en vivo o próximos y que un usuario sigue; también puedes ayudar a los anfitriones a comprender mejor el rendimiento de sus Spaces y obtener más información sobre su audiencia.
Los siguientes recursos te ayudarán a empezar a trabajar con los endpoints de Spaces:
A diferencia de otros recursos de la Plataforma de Desarrolladores de X, Spaces tienen un ciclo de vida definido. Se pueden programar Spaces hasta con 14 días de antelación respecto a su fecha de inicio prevista y dejan de estar disponibles después de que finalizan. Un host también puede cancelar un Space previamente 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 recuperación mediante los endpoints de Spaces, y se devolverá un mensaje de error para indicar esta condición.
Cuando tu App procese datos de Spaces, eres responsable de devolver la información más reciente 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 y la intención de tus usuarios.
Estos endpoints reflejan la forma en que funcionan los Spaces en la app de X. En los Spaces, los usuarios de X pueden tener roles definidos según cómo interactúan con un Space y cómo participan en él.
El anfitrión principal es el usuario que creó un Space y el propietario de ese 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 asignar a uno o más usuarios como 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 aplicación identificará al anfitrión principal comprobando el valor de creator_id y a los coanfitriones comprobando los valores de host_ids.
Los Speakers son usuarios que tienen permiso para hablar en el Space. En cualquier momento puede haber desde cero Speakers hasta un máximo de 10 (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 para obtener una lista de objetos de usuario.
Un oyente puede escuchar un Space, reaccionar en cualquier momento usando las reacciones predefinidas y solicitar convertirse en orador (cuando los anfitriones lo permiten en la configuración del Space). La información sobre los oyentes solo se devolverá como un recuento agregado de participantes (incluidos los anfitriones) en el campo participant_count.