- Herramientas útiles
- Conceptos clave
Guías
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 administración de Bookmarks en tu sistema. Hemos dividido la página en un par de secciones:
Antes de adentrarnos en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:
Postman es una herramienta excelente 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”.
¿Le interesa configurar este endpoint con código en su lenguaje de programación preferido? Tenemos varios ejemplos de código que puede usar como punto de partida en nuestra página de GitHub.
Aproveche una de las bibliotecas de terceros de nuestras comunidades para comenzar. Puede encontrar una biblioteca compatible con los endpoints de v2 buscando la etiqueta de versión correspondiente.
Todos los endpoints de X API v2 requieren que autentiques tus solicitudes con un conjunto de credenciales, también conocido como keys and tokens.
Estos endpoints específicos requieren el uso de OAuth 2.0 Authorization Code Flow with PKCE, lo que significa que debes usar un conjunto de keys 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 utilizando un Authorize URL.
Ten en cuenta que OAuth 2.0 puede resultar complejo de usar. Si no estás familiarizado con este método de autenticación, te recomendamos usar una library o una herramienta como Postman para autenticar correctamente tus solicitudes.
Para obtener un conjunto de credenciales de autenticación que funcionen con los endpoints de la 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. Luego podrás encontrar tus keys and tokens dentro de tu App de desarrollador.
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 velocidad 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 estás realizando la solicitud solo puede invocar el endpoint un número determinado de veces en cualquier App de desarrollador. Existe un límite de velocidad por usuario de 180 solicitudes por ventana de 15 min para el método GET. Con el método GET del endpoint de Bookmarks lookup recibirás 800 de tus Posts guardados más recientes. Además, existe un límite de velocidad por usuario de 50 solicitudes por ventana de 15 min para los métodos POST y DELETE.
⌘I