Saltar al contenido principal

​
Cómo integrar los endpoints de recuento de Posts

Esta página contiene información sobre varias herramientas y conceptos clave que debes conocer al integrar en tu sistema los endpoints de recuento de Posts recientes o de archivo completo. Hemos dividido la página en las siguientes secciones:

​
Herramientas útiles

Antes de comenzar a explorar algunos conceptos clave, recomendamos usar una de las siguientes herramientas o ejemplos de código para empezar a probar la funcionalidad de estos endpoints.

​
Ejemplos de código

¿Le interesa configurar estos endpoints 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, incluido un cliente de Python.

​
Bibliotecas

Aprovecha una de nuestras bibliotecas comunitarias de terceros para empezar. Puedes encontrar una biblioteca compatible con los endpoints de v2 buscando la etiqueta de versión correspondiente.

​
Postman

Postman es una excelente herramienta que puede usar para probar estos endpoints. Cada solicitud de Postman incluye todos los parámetros del endpoint correspondiente para ayudarle a comprender rápidamente qué está disponible para usted. Para obtener más información sobre nuestras colecciones de Postman, visite nuestra página Uso de Postman.  

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren que las solicitudes estén autenticadas con un conjunto de credenciales, también conocidas como keys and tokens. Este endpoint en particular requiere el uso de OAuth 2.0 Bearer Token, lo que significa que debes incluir un Bearer Token para realizar la solicitud correctamente. Puedes generar un Bearer Token directamente en una App de desarrollador o generar uno mediante el endpoint POST oauth2/token.

​
Portal de desarrolladores, Projects y Apps de desarrollador

Para trabajar con cualquier endpoint de X API v2, debes tener una cuenta de desarrollador, configurar un Project dentro de esa cuenta y crear una App de desarrollador dentro de ese Project. Tus keys and tokens de esa App de desarrollador funcionarán para los endpoints de conteo de Posts recientes. Si deseas utilizar el endpoint de conteo de Posts de archivo completo, o utilizar los operadores avanzados y una longitud de query mayor, necesitarás haber sido aprobado para acceso Enterprise. Visita nuestra sección sobre acceso Enterprise para obtener más información.

​
Límites de tasa

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el volumen, se aplican límites de tasa a cada endpoint que limitan la cantidad de solicitudes que cada desarrollador puede realizar en nombre de una App o de un usuario autenticado. Este endpoint tiene límites de tasa a nivel de App, lo que significa que usted, como desarrollador, solo puede realizar una cierta cantidad de solicitudes a este endpoint durante un período de tiempo determinado desde cualquier App (según las credenciales que esté utilizando). 

​
Creación de consultas

La característica principal de estos endpoints es el uso de una única query para filtrar los Posts en los conteos que se te entregan. Estas queries están compuestas por operadores que hacen coincidir atributos de Post y de usuario, como palabras clave del mensaje, hashtags y URL. Los operadores pueden combinarse en queries con lógica booleana y paréntesis para refinar el comportamiento de coincidencia de la query. Puedes usar nuestra guía sobre cómo crear una query para obtener más información. Para los recuentos de Post recientes, no se devuelve next_token, lo que significa que, independientemente de la granularidad, obtendrás el volumen de Post de los últimos 7 días en una sola llamada a la API. Para los recuentos de Post del archivo completo, obtendrás data de los últimos 30 días. Para data de más de 30 días, recibirás un next_token que luego podrás usar para paginar y obtener la data adicional. 

​
Creación de consultas para recuentos de Posts

Los endpoints de recuento de Posts aceptan una única query con una solicitud GET y devuelven un conjunto de recuentos históricos de Posts que coinciden con la query. Las consultas se componen de operadores que se utilizan para hacer coincidir una variedad de atributos de los Posts. 

​
Tabla de contenidos

⌘I