Puedes usar lo que lees en FeedBro en otras apps y herramientas de dos formas. Los enlaces RSS convierten tus artículos Guardados, o una colección, en un feed que cualquier app de RSS o herramienta de automatización puede leer, sin configurar nada. La API para desarrolladores permite que tus propios scripts y apps lean tus feeds y artículos y, con el Coffee Club, que también los marquen como leídos o guardados.
Tu lectura en enlaces RSS
Un feed RSS es una lista de artículos recientes que las apps pueden revisar para ver si hay novedades. FeedBro te da enlaces RSS privados de tus propias listas:
- Guardados: los artículos que guardaste en FeedBro. Todos los planes tienen este enlace.
- Un enlace por colección, con los artículos más recientes de todos los feeds de esa colección. Esto es parte del Coffee Club.
Puedes usarlos para enviar tus artículos guardados a otra app de lectura, a un servicio de "leer más tarde", a un chat de equipo o a una herramienta de automatización que entienda RSS.
Cómo copiar tus enlaces RSS
- Inicia sesión en feedbro.com y abre Ajustes (desde el menú de tu foto de perfil).
- Haz clic en la pestaña Feeds.
- Busca la tarjeta Tu lectura en RSS.
- Junto a Guardados (y, con el Coffee Club, junto al nombre de cada colección), haz clic en Copiar. El botón cambia a Copiado durante un momento. También puedes hacer clic dentro del cuadro para seleccionar el enlace.
- Pega el enlace en tu otra app, donde te pida la dirección de un feed.
En el plan Free, tus colecciones aparecen con un candado y la nota "Los enlaces de colecciones son parte de Coffee Club." Con el Coffee Club, si todavía no tienes colecciones, la tarjeta dice "Crea una colección para tener también su enlace RSS."
Qué lleva cada elemento
- El título del artículo y un enlace al artículo original en el sitio del editor.
- El resumen corto que publicó el propio feed (hasta unos 600 caracteres), si lo hay.
- La fecha de publicación.
No se incluye el texto completo del artículo que obtuvo FeedBro. Tu otra app abre la página original cuando haces clic en un elemento.
Límites de cada plan
En el plan Free tienes solo el enlace de Guardados, con tus últimos 20 artículos guardados. Se actualiza como mucho cada 15 minutos.
Con el Coffee Club tienes el enlace de Guardados y un enlace para cada colección, con 50 artículos cada uno. Se actualizan como mucho cada 5 minutos.
Si dejas el Coffee Club, los enlaces de tus colecciones siguen abriéndose, pero una app de RSS solo muestra un elemento que dice "Los enlaces de colecciones son parte de Coffee Club."
Mantén los enlaces en privado
Los enlaces contienen un código secreto y funcionan sin iniciar sesión, para que otras apps puedan leerlos. Eso también significa que cualquiera que tenga un enlace puede leer esa lista, así que no los compartas.
Si has compartido un enlace por error:
- Abre Ajustes y luego la pestaña Feeds.
- En Tu lectura en RSS, haz clic en Restablecer enlaces.
- Verás "Tus enlaces RSS anteriores ya no funcionan. Los nuevos están abajo." Copia los enlaces nuevos en las apps que quieras seguir usando.
Al restablecerlos se desactivan todos los enlaces anteriores a la vez: el de Guardados y todos los de colecciones.
La API para desarrolladores
Una API es una forma de que los programas hablen directamente con FeedBro. Con una clave de API personal (un código secreto largo que funciona como la contraseña de un programa), un script o una app puede leer tus feeds, colecciones, artículos y páginas guardadas en JSON (un formato de texto sencillo que leen los programas). Usa tu propia cuenta, así que lo que cambie aparece en FeedBro, y al revés.
Límites de cada plan
En el plan Free tienes 1 clave y 500 solicitudes al mes, hasta 30 solicitudes por minuto por clave, solo para leer.
Con el Coffee Club tienes hasta 5 claves y 100 solicitudes al día, hasta 60 solicitudes por minuto por clave. Las claves también pueden marcar artículos como leídos, guardados o para leer más tarde. Pueden lanzar tareas en segundo plano (como obtener el texto completo de un artículo o sacar el texto principal de cualquier página web) y enviar los resultados a un webhook (una dirección de tu propio servidor a la que FeedBro llama cuando algo está listo).
El recuento mensual del plan Free vuelve a empezar el día 1 de cada mes, y el diario del Coffee Club a medianoche UTC. La mayoría de las solicitudes cuentan como 1. Las tareas en segundo plano cuentan más porque hacen más trabajo: obtener un artículo o extraer una página cuenta como 10, seguir un feed como 5 y empezar a vigilar un sitio web como 25. Si una tarea falla, cuenta como 1 y se te devuelve el resto.
Cómo crear una clave de API
- Abre Ajustes y haz clic en la pestaña API.
- En la tarjeta Acceso a la API, escribe un nombre para la clave en el cuadro (por ejemplo "Mi script"), para distinguir tus claves más adelante.
- Haz clic en Crear clave.
- La clave aparece con el mensaje "Copia esta clave ahora. Solo se muestra una vez." Haz clic en Copiar y guarda la clave en un lugar seguro, como un gestor de contraseñas.
Tus claves aparecen en la misma tarjeta con su nombre y la última vez que se usaron ("Aún sin usar" hasta la primera solicitud). Para que una clave deje de funcionar, haz clic en Revocar junto a ella y confirma. Si pierdes una clave, revócala y crea una nueva.
Cómo ver cuánto has usado
La tarjeta Uso, arriba en la pestaña API, muestra por ejemplo "12 de 500 solicitudes este mes", cuántas te quedan, la fecha en que se reinicia el recuento y cuántas solicitudes por minuto puede enviar cada clave. El gráfico Últimos 30 días muestra tus solicitudes por día. Debajo de las claves, Tareas recientes en segundo plano enumera las tareas que lanzaron tus claves, con su estado (En espera, En curso, Hecho o Falló), cuánto tardaron y cuánto contaron.
La documentación de la API y la zona de pruebas
La documentación completa está en la página API de FeedBro. Puedes llegar a ella desde el enlace documentación de la API de Ajustes, o desde API para desarrolladores, al pie de cada página. Explica cada solicitud, con respuestas de ejemplo y todos los mensajes de error. La página está en inglés, así que sus botones se citan aquí tal como aparecen.
La página tiene una zona de pruebas llamada Try it, donde puedes probar solicitudes sin escribir código:
- Pega tu clave en el cuadro API key. Se oculta mientras escribes; el botón del ojo la muestra.
- Elige una solicitud de la lista Call, por ejemplo GET /summary/unread-count. La línea de debajo explica qué hace, si necesita el Coffee Club y cuánto cuenta.
- Rellena los campos que aparezcan. Los marcados con * son obligatorios.
- Haz clic en Send. La respuesta aparece debajo, con su estado y cuántas solicitudes te quedan.
- Haz clic en Copy as curl para copiar la misma solicitud como un comando que puedes ejecutar en un terminal.
Las solicitudes de la zona de pruebas son reales: usan tu cuenta y cuentan para tu plan. Tu clave no se guarda en ningún sitio y se queda en el cuadro solo hasta que sales de la página. Si usas Postman (una herramienta muy usada para probar APIs), la página también tiene Download the Postman collection.
Un primer ejemplo explicado
Cada solicitud va a una dirección que empieza por https://feedbro.com/api/v1 y lleva tu clave en una cabecera llamada Authorization, con la forma Bearer seguido de un espacio y tu clave. Por ejemplo, un programa que pide GET /summary/unread-count recibe un número, cuántos artículos sin leer tienes en todos tus feeds, más la hora en que se calculó. Un programa que pide GET /articles con filter=unread recibe tus artículos sin leer, de 25 en 25, los más recientes primero. Cada uno llega con su título, enlace, resumen, imagen y si está leído, guardado o en Leer más tarde.
Leer un artículo con una clave no lo marca como leído en FeedBro. Además, la API nunca hace esperar a tu programa mientras se obtiene un sitio. Responde con lo que FeedBro ya tiene, y todo lo que haya que obtener se hace como tarea en segundo plano.
Conviene saber
- Trata una clave de API como una contraseña, porque cualquiera que la tenga puede leer tu cuenta. No la pegues nunca en una página pública ni la compartas en una captura de pantalla.
- Si una app solo entiende RSS, no necesitas ninguna clave. Usa tus enlaces RSS.
- Tus enlaces RSS y tus claves de API son independientes. Restablecer los enlaces RSS no afecta a tus claves, y revocar una clave no afecta a tus enlaces.
Si algo no funciona
"Unauthenticated."
Falta la clave, está mal escrita o se revocó. Revisa la cabecera Authorization o crea una clave nueva.
"On the Free plan an API key can read only." o "Background jobs and webhooks are part of Coffee Club."
La solicitud necesita el Coffee Club. La API responde en inglés: estos mensajes dicen que en el plan Free una clave solo puede leer y que las tareas en segundo plano y los webhooks son parte del Coffee Club.
"Too many requests this minute. Wait a moment and try again."
Tu programa envía solicitudes demasiado rápido. Espera los segundos que indica la respuesta y vuelve a intentarlo.
"Monthly limit reached" (plan Free) o el límite diario (Coffee Club)
Has gastado tus solicitudes hasta la fecha de reinicio que aparece en la respuesta y en la tarjeta Uso.
"El plan gratuito incluye 1 clave de API. Coffee Club permite hasta 5." o "Puedes tener hasta 5 claves. Revoca una primero."
Revoca una clave que ya no uses antes de crear otra.
Mi app de RSS ha dejado de actualizarse
Si hiciste clic en Restablecer enlaces, los enlaces anteriores ya no funcionan. Copia los nuevos desde Ajustes, pestaña Feeds.
El enlace RSS de mi colección muestra un solo elemento sobre el Coffee Club
Los enlaces de colecciones necesitan el Coffee Club. El enlace de Guardados funciona en todos los planes.
Mi artículo guardado todavía no aparece en la app de RSS
Los enlaces se actualizan como mucho cada 15 minutos en el plan Free y cada 5 minutos con el Coffee Club, y tu app de RSS revisa según su propio horario. Espera un poco y vuelve a mirar.
