Saltar al contenido principal
Esta página presenta herramientas y conceptos clave para integrar en tu sistema los endpoints para gestionar Publicaciones.

​
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 todo lo que tienes disponible. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Uso de Postman”.

​
Ejemplos de código

¿Te interesa configurar 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 nuestro repositorio de GitHub.

​
Bibliotecas de terceros

Aprovecha una de las bibliotecas de terceros de nuestras comunidades para ayudarte a empezar. Puedes encontrar una biblioteca que funcione con los endpoints de 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 concreto requieren el uso de OAuth 1.0a User Context, lo que significa que debes usar un conjunto de claves de API y tokens de acceso de usuario (Access Tokens) para realizar una solicitud correcta. Los Access Tokens deben estar asociados con el usuario en cuyo nombre estás realizando la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, este debe autorizar o autenticar tu App utilizando el flujo OAuth de 3 participantes (3-legged OAuth flow). Ten en cuenta que OAuth 1.0a puede ser difícil de usar. Si no estás familiarizado con este método de autenticación, te recomendamos que uses una biblioteca, una herramienta como Postman o OAuth 2.0 para autenticar tus solicitudes. OAuth 2.0 Authorization Code with PKCE permite un mayor control sobre el alcance de una aplicación y sobre los flujos de autorización en varios dispositivos. OAuth 2.0 te permite elegir ámbitos específicos y granulares que te otorgan permisos específicos en nombre de un usuario. Para habilitar OAuth 2.0 en tu App, debes activarlo en la configuración de autenticación de tu App, que se encuentra en la sección de configuración de la App en la Consola de desarrollador.

​
Consola de desarrollador, Proyectos y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que sean compatibles con los endpoints de X API v2, debes tener una [cuenta de desarrollador]/resources/fundamentals/developer-portal), configurar 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 realizar 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 realizas la solicitud solo puede llamar al endpoint un número determinado de veces desde cualquier App de desarrollador. Hay un límite de tasa por usuario de 200 solicitudes cada 15 minutos para el método POST. El método DELETE tiene un límite de tasa de 50 solicitudes cada 15 minutos. Además, hay un límite de 300 solicitudes cada 3 horas, incluidas las Publicaciones creadas mediante manage Posts o manage Retweets.

​
Etiquetas de origen

El nombre de tu App y la URL de tu sitio web se mostrarán como la etiqueta de origen dentro de los metadatos de cualquier Publicación generada mediante programación por tu aplicación. Si cambias el caso de uso de tu App de X, asegúrate de actualizarlo en esta configuración para garantizar que sigues cumpliendo con los Developer Terms.

​
Configuración del perfil

Solo puedes agregar una ubicación a las Publicaciones si tienes la geo habilitada en la configuración de tu perfil. Si no tienes la geo habilitada, todavía puedes agregar un parámetro de ubicación en el cuerpo de tu solicitud, pero no se adjuntará a tu Publicación. Lo mismo ocurre al etiquetar usuarios en imágenes. Si el usuario al que estás etiquetando no tiene habilitado el etiquetado de fotos, su nombre no aparecerá en la lista de usuarios etiquetados aunque la Publicación se cree correctamente.

​
Añadir contenido multimedia a una Publicación

Actualmente, no hay ninguna forma de cargar por completo contenido multimedia usando X API v2. Sin embargo, puedes adjuntar contenido multimedia previamente cargado a una Publicación. Puedes usar id de contenido multimedia que ya se hayan cargado usando el endpoint de contenido multimedia de la v1 o X Media Studio. Estos id de contenido multimedia deben ser tuyos o de un usuario autenticado.

​
Ejemplos de código

​
Crear una Publicación

cURL
curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

​
Crear una respuesta

cURL
curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "¡Esta es una respuesta!", "reply": {"in_reply_to_tweet_id": "1234567890"}}'

​
Eliminar una publicación

cURL
curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: OAuth ..."
Próximos pasos Referencia de la API