Guía de integración

Esta página contiene información sobre varias herramientas y conceptos fundamentales que debes conocer al integrar los endpoints de Lists en tu sistema. Hemos dividido la página en varias secciones:

• Herramientas útiles
• Conceptos clave
• Autenticación
• Portal de desarrolladores, Projects y Apps
• Límites de uso

​

Herramientas útiles

Antes de adentrarnos en algunos conceptos clave que te ayudarán a integrar este endpoint, te recomendamos familiarizarte 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é 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 nuestra página de GitHub.

​

Bibliotecas de terceros

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

​

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 específicos requieren el uso de Contexto de usuario de OAuth 1.0a (/es/resources/fundamentals/authentication), lo que significa que debes usar un conjunto de claves de API y tokens de acceso de usuario para realizar una solicitud correctamente. Los tokens de acceso deben estar asociados con el usuario en cuyo nombre realizas la solicitud. Si deseas generar un conjunto de tokens de acceso para otro usuario, ese usuario debe autorizar o autenticar tu App mediante el flujo de OAuth de 3 patas (/es/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow).

Ten en cuenta que OAuth 1.0a puede resultar complejo de usar. Si no estás familiarizado con este método de autenticación, te recomendamos usar una biblioteca (/es/x-api/tools-and-libraries/overview) o una herramienta como Postman para autenticar correctamente tus solicitudes.  

​

Portal de desarrolladores, Projects y Apps de desarrollador

Para obtener un conjunto de credenciales de Autenticación que funcionen con los endpoints de X API v2, debes registrarte para una cuenta de desarrollador, configurar un Project Project dentro de esa cuenta y crear una App de desarrollador App de desarrollador dentro de ese Project. Luego podrás encontrar tus claves y tokens dentro de tu App de desarrollador.  

​

Límites de uso

Cada día, muchos miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran volumen de estas solicitudes, se aplican límites de uso a cada endpoint que restringen la cantidad de solicitudes que puedes realizar en nombre de tu App o de un usuario autenticado. 

Estos endpoints tienen límites de uso a nivel de usuario, lo que significa que el usuario autenticado en cuyo nombre realizas la solicitud solo puede invocar el endpoint un número determinado de veces desde cualquier App de desarrollador. 

La siguiente tabla muestra los límites de uso para cada endpoint.

Endpoint	Método HTTP	Límite de uso
/2/lists	POST	300 solicitudes por 15 minutos
/2/lists/:id	DELETE / PUT	300 solicitudes por 15 minutos