Guía de integración
Descripción general
Esta página presenta las herramientas y los conceptos clave para la integración con los endpoints de recuentos de Publicaciones.
Antes de comenzar a explorar algunos conceptos clave, te recomendamos usar una de las siguientes herramientas o ejemplos de código para comenzar a probar la funcionalidad de estos endpoints.
¿Quieres configurar estos endpoints con código en tu lenguaje de programación preferido? Disponemos de varios ejemplos de código que puedes usar como punto de partida en nuestro repositorio de GitHub, incluido un cliente de Python.
Aprovecha una de nuestras muchas bibliotecas de terceros creadas por la comunidad para ayudarte a empezar. Puedes encontrar una biblioteca que funcione con los endpoints de la v2 buscando la etiqueta de versión adecuada.
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 que puedas entender rápidamente qué tienes disponible. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página Uso de Postman.
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 concreto requiere el uso de OAuth 2.0 Bearer Token, lo que significa que debes pasar un Bearer Token para realizar una solicitud exitosa. Puedes generar un Bearer Token directamente en una App de desarrollador o generar uno usando el endpoint POST oauth2/token.
Para trabajar con cualquier endpoint de X API v2, debes tener una cuenta de desarrollador, configurar un Proyecto dentro de esa cuenta y crear una App de desarrollador dentro de ese Proyecto. Tus claves y tokens dentro de esa App de desarrollador funcionarán para los endpoints de conteo de Publicaciones recientes. Si deseas utilizar el endpoint de conteo de Publicaciones del archivo completo o aprovechar los operadores avanzados y una longitud de consulta mayor, deberás haber sido aprobado para el acceso empresarial.
Visita nuestra sección sobre acceso empresarial para obtener más información.
Cada día, muchos miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el volumen, se aplican límites de tasa a cada endpoint, lo que limita la cantidad de solicitudes que cada desarrollador puede hacer en nombre de una App o de un usuario autenticado.
Este endpoint está sujeto a límites de tasa a nivel de App, lo que significa que tú, como desarrollador, solo puedes hacer una cierta cantidad de solicitudes a este endpoint durante un período de tiempo determinado desde cualquier App (según las credenciales que estés utilizando).
La característica central de estos endpoints es el uso de una sola consulta para filtrar las Publicaciones y obtener los conteos que se te devuelven. Estas consultas se componen de operadores que buscan coincidencias en atributos de la Publicación y del usuario, como palabras clave del mensaje, hashtags y URLs. Los operadores se pueden combinar en consultas con lógica booleana y paréntesis para ayudar a refinar cómo la consulta realiza las coincidencias.
Puedes consultar nuestra guía sobre cómo crear una consulta para obtener más información.
Para recuentos recientes de Publicaciones, no se devuelve ningún next_token, lo que significa que, independientemente de la granularidad, obtendrás el volumen de Publicaciones de los últimos 7 días en una sola llamada a la API.
Para recuentos de Publicaciones de archivo completo, obtendrás datos de los últimos 30 días. Para datos anteriores a esos 30 días, obtendrás un next_token que luego podrás usar para paginar y obtener los datos adicionales.