Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos fundamentales que debes conocer mientras integras los endpoints de gestión de marcadores en tu sistema. Hemos dividido la página en un par de secciones diferentes:

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave que te ayudarán a integrar este endpoint, te recomendamos que primero te familiarices 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é está disponible para ti. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Cómo usar Postman”.

​
Ejemplos de código

¿Te interesa empezar a usar este endpoint con código en tu lenguaje de programación preferido? Tenemos varios ejemplos de código disponibles que puedes usar como punto de partida en nuestra página de GitHub.

​
Bibliotecas de terceros

Aprovecha una de las bibliotecas de terceros de nuestras comunidades para ayudarte a comenzar. Puedes encontrar una biblioteca que sea compatible con los endpoints de la v2 buscando la etiqueta de versión adecuada.

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren que autentiques tus solicitudes con un conjunto de credenciales, también conocidas como claves y tokens. Estos endpoints en particular requieren el uso de OAuth 2.0 Authorization Code Flow with PKCE, lo que significa que debes usar un conjunto de claves y Access Tokens de usuario para realizar una solicitud exitosa. Los Access Tokens deben estar asociados con el usuario en cuyo nombre estás realizando la solicitud. Si quieres generar un conjunto de Access Tokens para otro usuario, esa persona debe autorizar tu App o autenticarse en ella utilizando una Authorize URL. Ten en cuenta que OAuth 2.0 puede ser complicado de usar. Si no estás familiarizado con este método de autenticación, te recomendamos usar una librería o una herramienta como Postman para autenticar tus solicitudes correctamente.

​
Consola de desarrollador, Proyectos y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que funcionen con los endpoints de X API v2, debes tener una cuenta de desarrollador, haber configurado un Proyecto dentro de esa cuenta y haber creado una App de desarrollador dentro de ese Proyecto. Luego podrás encontrar tus claves y 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 enorme 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 en nombre 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 estás realizando la solicitud solo puede llamar al endpoint un número determinado de veces desde cualquier App de desarrollador. Existe un límite de tasa por usuario de 180 solicitudes por ventana de 15 minutos para el método GET. Con el método GET del endpoint Bookmarks lookup obtendrás 800 de tus Publicaciones más recientes en Marcadores. Además, existe un límite de tasa por usuario de 50 solicitudes por ventana de 15 minutos para los métodos POST y DELETE.

​
Ejemplos de código

​
Obtener marcadores

cURL
curl "https://api.x.com/2/users/123/bookmarks?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
Crear un marcador

cURL
curl -X POST "https://api.x.com/2/users/123/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'