- 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 para gestionar Bookmarks en tu sistema. Hemos dividido la página en un par de secciones:
Antes de profundizar en algunos conceptos clave que te ayudarán a integrar este endpoint, te recomendamos que te familiarices con:
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 la página “Uso de Postman”.
¿Te interesa configurar este endpoint con código en tu lenguaje de programación preferido? Tenemos varios ejemplos disponibles que puedes usar como punto de partida en nuestra página de GitHub.
Aprovecha una de nuestras comunidades bibliotecas de terceros para empezar. Puedes 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 conocidas como claves y tokens.
Estos endpoints en particular requieren el uso de OAuth 2.0 Authorization Code Flow with PKCE (OAuth 2.0 Authorization Code Flow with PKCE), lo que significa que debes usar un conjunto de claves y tokens de acceso de usuario para realizar una solicitud correcta. Los tokens de acceso deben estar asociados con el usuario en cuyo nombre haces la solicitud. Si quieres generar un conjunto de tokens de acceso para otra persona, esa persona debe autorizar o autenticar tu App mediante una Authorize URL (URL de autorización).
Ten en cuenta que OAuth 2.0 puede resultar complejo. Si no estás familiarizado con este método de autenticación, te recomendamos usar una library o una biblioteca 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 X API v2, debes tener una cuenta de desarrollador (/es/resources/fundamentals/developer-portal), configurar un Proyecto (/es/resources/fundamentals/projects) dentro de esa cuenta y crear una App de desarrollador (/es/resources/fundamentals/developer-apps) dentro de ese Proyecto. Luego podrás encontrar tus claves y tokens en tu App de desarrollador.
Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran volumen de estas solicitudes, se aplican límites de frecuencia 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 frecuencia 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 en cualquier App de desarrollador. Existe un límite de 180 solicitudes por ventana de 15 minutos para el método GET. Con el método GET del endpoint de Bookmarks lookup recibirás hasta 800 de tus Posts guardados más recientes. Además, existe un límite de 50 solicitudes por ventana de 15 minutos para los métodos POST y DELETE.