Guía de integración

Esta página contiene información sobre varias herramientas y conceptos fundamentales que debe conocer al integrar los endpoints de List en su sistema. Hemos dividido la página en un par de secciones:

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

​

Herramientas útiles

Antes de adentrarnos en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:

​

Postman

Postman es una excelente herramienta que puede usar para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarle a comprender rápidamente qué tiene disponible. Para obtener más información sobre nuestras colecciones de Postman, visite nuestra página “Using Postman”. 

​

Ejemplos de código

¿Le interesa empezar a usar este endpoint con código en su lenguaje de programación preferido? Contamos con varios ejemplos de código que puede utilizar 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 biblioteca 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 keys and tokens. 

Estos endpoints requieren el uso de Contexto de usuario de OAuth 1.0a, lo que significa que debes usar un conjunto de API Key y Access Tokens de usuario para realizar una solicitud correctamente. Los Access Tokens deben estar asociados con el usuario en cuyo nombre realizas la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, ese usuario debe autorizar o autenticar tu App mediante el flujo de OAuth de 3 fases.

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 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 la X API v2, debes registrarte para una cuenta de desarrollador, configurar un Project dentro de esa cuenta y crear una App de desarrollador dentro de ese Project. Luego podrás encontrar tus keys and tokens dentro de tu App de desarrollador.  

​

Límites de velocidad

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 tasa a cada endpoint que limitan la cantidad de solicitudes que puedes realizar en nombre de tu App o de un usuario autenticado. 

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

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

Endpoint	método HTTP	límite de tasa
/2/lists	POST	300 solicitudes por 15 minutos
/2/lists/:id	DELETE / PUT	300 solicitudes por 15 minutos