Instapaper estrena API v2 con OAuth 2, SDK y sincronización por cambios
La API v2 de Instapaper añade OAuth 2, tokens de acceso personal, endpoints JSON y SDK de Python y TypeScript. La versión 1 sigue viva, pero xAuth se apagará el 30 de septiembre de 2027.
Instapaper ha publicado la versión 2 de su API. El salto trae OAuth 2, tokens de tipo bearer, endpoints REST con respuestas JSON y tokens de acceso personal pensados para scripts y herramientas propias. Además desaparecen los límites de paginación al listar marcadores, se añade sincronización basada en since y llegan endpoints para gestionar etiquetas.
Para quien integra Instapaper en un cliente, una extensión o un flujo de automatización, el cambio no es cosmético. La API v1 sigue funcionando, pero xAuth se apagará el 30 de septiembre de 2027. Eso deja una ventana de migración, no un apagado inmediato, aunque quien mantenga una integración con xAuth ya tiene una fecha límite en el calendario.
Qué trae la versión 2
OAuth 2 y los tokens bearer son el mecanismo de autenticación de la nueva API. Los tokens de acceso personal cubren el caso de scripts personales, esos que no quieren montar un flujo completo de autorización. Para servicios y aplicaciones de terceros, OAuth 2 es la vía estándar.
El otro bloque es la sincronización. La API v2 elimina el tope de paginación al recuperar marcadores y añade un modo de sincronización basado en since, pensado para pedir solo lo que ha cambiado desde una marca temporal. En la práctica, eso reduce el trabajo de los clientes que mantienen una copia local de la cuenta y tienen que reconciliarla cada cierto tiempo.
También hay endpoints para gestionar etiquetas, algo que antes quedaba fuera o se resolvía de forma menos directa según el cliente. No es la parte más vistosa, pero para herramientas de clasificación y para exportaciones automatizadas es la clase de pieza que se echa de menos cuando no está.
La documentación viene con SDK oficiales para Python y TypeScript, además de una especificación OpenAPI completa. Eso baja el coste de arranque: quien quiera generar un cliente, validar respuestas o montar pruebas contra la API no tiene que reconstruir el contrato a mano. La especificación OpenAPI es también la base para generar stubs y mantener el tipado en TypeScript.
No hay cifras de rendimiento, límites de tasa ni detalles de despliegue en el anuncio. Lo que sí está claro es el calendario: v1 sigue soportada y xAuth tiene fecha de retirada. Si mantienes una integración con Instapaper, toca revisar qué endpoints usas y si dependes de xAuth. La API v2 no rompe de golpe, pero deja el camino marcado.
