Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos clave que debe conocer al integrar los endpoints de mutes en su sistema. Hemos dividido la página en varias secciones:

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:

​
Postman

Postman es una excelente herramienta que puedes usar para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarte a comprender rápidamente qué tienes disponible. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Using Postman”. 

​
Ejemplos de código

¿Le interesa configurar este endpoint con código en su lenguaje de programación preferido? Contamos con varios ejemplos de código que puede usar como punto de partida en nuestra página de GitHub.

​
Bibliotecas de terceros

Aprovecha alguna de las bibliotecas de terceros de nuestra comunidad para comenzar. Puedes encontrar una biblioteca compatible con los endpoints de v2 buscando la etiqueta de versión correspondiente.

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren que autentique sus solicitudes con un conjunto de credenciales, también conocidas como keys and tokens. Puede usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE para autenticar sus solicitudes a estos endpoints. Contexto de usuario de OAuth 1.0a requiere que utilice sus API Keys, Access Tokens de usuario y algunos otros parámetros para crear un encabezado de autorización, que luego enviará con su solicitud. Los Access Tokens deben estar asociados con el usuario en cuyo nombre realiza la solicitud. Si desea generar un conjunto de Access Tokens para otro usuario, esa persona debe autorizar su App utilizando el flujo de OAuth de 3 fases. Tenga en cuenta que OAuth 1.0a puede ser difícil de usar. Si no está familiarizado con este método de autenticación, le recomendamos usar una biblioteca, una herramienta como Postman o usar OAuth 2.0 para autenticar sus solicitudes. El Código de autorización de OAuth 2.0 con PKCE permite un mayor control sobre el scope de una aplicación y flujos de autorización en múltiples dispositivos. OAuth 2.0 le permite elegir scopes específicos y granulares que le otorgan permisos concretos en nombre de un usuario. Para habilitar OAuth 2.0 en su App, debe activarlo en la configuración de autenticación de su App, ubicada en la sección de configuración de la App del portal de desarrolladores.

​
Portal de desarrolladores, Projects y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que funcionen con los endpoints de la X API v2, debes registrarte para una cuenta de desarrollador, configurar un Project dentro de esa cuenta y crear una App de desarrollador dentro de ese Project. Luego podrás encontrar tus keys and tokens dentro de tu App de desarrollador.  

​
Límites de tasa

Cada día, muchos miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran volumen de estas solicitudes, se aplican límites de tasa a cada endpoint que limitan la cantidad de solicitudes que puedes hacer en nombre de tu App o de un usuario autenticado.  Estos endpoints tienen límites de tasa a nivel de usuario, lo que significa que el usuario autenticado en cuyo nombre realizas la solicitud solo puede invocar el endpoint un cierto número de veces desde cualquier App de desarrollador. Existe un límite de tasa por usuario de 50 solicitudes por 15 minutos por endpoint para los métodos POST y DELETE. Sin embargo, con el método GET, el límite de tasa es de solo 15 solicitudes por 15 minutos.  

​
Campos y expansions

El endpoint GET de X API v2 permite a los usuarios seleccionar exactamente qué data desean obtener de la API mediante un conjunto de herramientas llamadas fields y expansions. El parámetro expansions permite incluir en la respuesta los objetos referenciados en el payload. Por ejemplo, este endpoint permite recuperar las siguientes expansions:
  • pinned_tweet_id
El parámetro fields permite seleccionar exactamente qué fields dentro de los diferentes objetos de data desea recibir. Este endpoint devuelve principalmente objetos de usuario. De forma predeterminada, el objeto de usuario devuelve los campos id, name y username. Para recibir campos adicionales como user.created_at o user.entities, deberá solicitarlos específicamente usando el parámetro fields.  Hemos añadido una guía sobre cómo usar fields y expansions conjuntamente en nuestro diccionario de datos de X API v2. La consulta de silencios puede devolver una gran cantidad de datos. Para garantizar resultados coherentes y de alto rendimiento en todo momento, usamos paginación. La paginación es una característica de los endpoints de X API v2 que devuelven más resultados de los que pueden incluirse en una sola respuesta. Cuando eso sucede, el campo data se devuelve en una serie de “páginas”. Obtén más información sobre cómo paginar los resultados.
Ten en cuenta: Si un usuario silencia desde X, hay un límite de 200 solicitudes cada 15 minutos.
⌘I