Saltar al contenido principal

​
Cómo integrar con los endpoints de conteo 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 conteo de Posts, ya sea del archivo reciente o de todo el archivo. Hemos dividido la página en las siguientes secciones:

​
Herramientas útiles

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

​
Ejemplos de código

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

​
Bibliotecas

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

​
Postman

Postman es una excelente herramienta que puedes usar para probar estos endpoints. Cada solicitud de Postman incluye todos los parámetros del endpoint correspondiente para ayudarte a comprender rápidamente qué opciones tienes disponibles. Para obtener más información sobre nuestras colecciones de Postman, visita la página Using 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 claves y tokens. Este endpoint en particular requiere el uso de OAuth 2.0 Bearer Token, lo que significa que debes incluir un Bearer Token para que la solicitud se procese correctamente. Puedes generar un Bearer Token directamente en una App de desarrollador o generarlo mediante el endpoint POST oauth2/token.

​
Portal de desarrolladores, Proyectos y Apps de desarrollador

Para trabajar con cualquier endpoint de X API v2, debe tener una cuenta de desarrollador, configurar un Proyecto dentro de esa cuenta y crear una App de desarrollador dentro de ese Proyecto. Sus claves y tokens de esa App de desarrollador funcionarán con los endpoints de recuento de Posts recientes. Si desea usar el endpoint de recuento de Posts del archivo completo o utilizar los operadores avanzados y una mayor longitud de consulta, deberá haber sido aprobado para el acceso Empresarial. Visite nuestra sección sobre acceso Empresarial para obtener más información.

​
Límites de uso

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

​
Creación de consultas

La función central de estos endpoints es el uso de una única consulta para filtrar los Posts en los recuentos que se te entregan. Estas consultas se componen de operadores que hacen coincidir atributos de Post y de usuario, como palabras clave del mensaje, hashtags y URL. Los operadores pueden combinarse en consultas con lógica booleana y paréntesis para refinar el comportamiento de coincidencia de la consulta. Puedes consultar nuestra guía sobre cómo crear una consulta para obtener más información. Para los conteos de Post recientes, no se devuelve ningún 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 conteos de Post de 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 puedes 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 consulta mediante una solicitud GET y devuelven un conjunto de recuentos históricos de Posts que coinciden con la consulta. Las consultas se componen de operadores que se utilizan para hacer coincidir diversos atributos de los Posts. 

​
Tabla de contenido