Puoi usare le tue letture di FeedBro in altre app e strumenti in due modi. I link RSS trasformano i tuoi articoli Salvati, o una raccolta, in un feed che qualsiasi app RSS o strumento di automazione può leggere, senza alcuna configurazione. L'API per sviluppatori permette ai tuoi script e alle tue app di leggere feed e articoli e, con il Coffee Club, anche di segnarli come letti o salvati.
Le tue letture come link RSS
Un feed RSS è un elenco degli articoli più recenti che le app possono controllare per vedere se ci sono novità. FeedBro ti dà link RSS privati per i tuoi elenchi:
- Salvati: gli articoli che hai salvato in FeedBro. Questo link c'è con ogni piano.
- Un link per ogni raccolta, con gli articoli più recenti di tutti i feed di quella raccolta. Fa parte del Coffee Club.
Puoi usarli per mandare i tuoi articoli salvati a un'altra app di lettura, a un servizio "leggi più tardi", a una chat di gruppo o a uno strumento di automazione che capisce l'RSS.
Come copiare i tuoi link RSS
- Accedi su feedbro.com e apri Impostazioni (dal menu sotto la tua immagine del profilo).
- Fai clic sulla scheda Feed.
- Cerca il riquadro Le tue letture in RSS.
- Accanto a Salvati (e, con il Coffee Club, accanto al nome di ogni raccolta), fai clic su Copia. Per un attimo il pulsante diventa Copiato. Puoi anche fare clic dentro la casella per selezionare il link.
- Incolla il link nell'altra app, dove ti chiede l'indirizzo di un feed.
Con il piano Free le tue raccolte compaiono con un lucchetto e la nota "I link delle raccolte fanno parte di Coffee Club." Con il Coffee Club, se non hai ancora raccolte, il riquadro dice "Crea una raccolta per avere anche il suo link RSS."
Cosa c'è in ogni elemento
- Il titolo dell'articolo e un link all'articolo originale sul sito dell'editore.
- Il breve riassunto pubblicato dal feed stesso (fino a circa 600 caratteri), quando c'è.
- La data di pubblicazione.
Il testo completo che FeedBro ha recuperato non è incluso. Quando fai clic su un elemento, l'altra app apre la pagina originale.
Limiti di ogni piano
Con il piano Free hai solo il link Salvati, con i tuoi ultimi 20 articoli salvati. Si aggiorna al massimo ogni 15 minuti.
Con il Coffee Club hai il link Salvati e un link per ogni raccolta, con 50 articoli ciascuno. Si aggiornano al massimo ogni 5 minuti.
Se lasci il Coffee Club, i link delle raccolte si aprono ancora, ma un'app RSS mostra un solo elemento con la scritta "I link delle raccolte fanno parte di Coffee Club."
Tieni privati i link
I link contengono un codice segreto e funzionano senza accesso, così le altre app possono leggerli. Questo vuol dire anche che chiunque abbia un link può leggere quell'elenco, quindi tienili per te.
Se hai condiviso un link per errore:
- Apri Impostazioni, poi la scheda Feed.
- In Le tue letture in RSS, fai clic su Reimposta i link.
- Compare il messaggio "I vecchi link RSS non funzionano più. Quelli nuovi sono qui sotto." Copia i nuovi link nelle app che vuoi continuare a usare.
Reimpostare disattiva tutti i vecchi link insieme: il link Salvati e tutti i link delle raccolte.
L'API per sviluppatori
Un'API è un modo con cui i programmi parlano direttamente con FeedBro. Con una chiave API personale (un lungo codice segreto che fa da password per un programma), uno script o un'app può leggere i tuoi feed, le raccolte, gli articoli e le pagine salvate in formato JSON (un semplice formato di testo che i programmi leggono). Usa il tuo account, quindi quello che cambia si vede in FeedBro, e viceversa.
Limiti di ogni piano
Con il piano Free hai 1 chiave e 500 richieste al mese, fino a 30 richieste al minuto per chiave, solo in lettura.
Con il Coffee Club hai fino a 5 chiavi e 100 richieste al giorno, fino a 60 richieste al minuto per chiave. Le chiavi possono anche segnare gli articoli come letti, salvati o da leggere dopo. Possono avviare attività in background (per esempio recuperare il testo completo di un articolo o estrarre il testo principale da una pagina web qualsiasi) e mandare i risultati a un webhook (un indirizzo sul tuo server che FeedBro chiama quando qualcosa è pronto).
Il conteggio mensile del piano Free riparte il 1° di ogni mese, quello giornaliero del Coffee Club a mezzanotte UTC. Quasi tutte le richieste contano 1. Le attività in background contano di più perché fanno più lavoro: recuperare un articolo o estrarre una pagina conta 10, seguire un feed 5, avviare il controllo di un sito 25. Se un'attività non riesce, conta 1 e il resto ti viene restituito.
Come creare una chiave API
- Apri Impostazioni e fai clic sulla scheda API.
- Nel riquadro Accesso API, scrivi un nome per la chiave nella casella (per esempio "Il mio script"), così in seguito distingui le tue chiavi.
- Fai clic su Crea chiave.
- La chiave compare con il messaggio "Copia questa chiave ora. Viene mostrata una sola volta." Fai clic su Copia e conserva la chiave in un posto sicuro, come un gestore di password.
Le tue chiavi sono elencate nello stesso riquadro, con il nome e la data dell'ultimo utilizzo ("Mai usato finora" fino alla prima richiesta). Per disattivare una chiave, fai clic su Revoca accanto a lei e conferma. Se perdi una chiave, revocala e creane una nuova.
Come vedere quanto hai usato
Il riquadro Utilizzo in cima alla scheda API mostra, per esempio, "12 di 500 richieste questo mese", quante ne restano, la data in cui il conteggio si azzera e quante richieste al minuto può mandare ogni chiave. Il grafico Ultimi 30 giorni mostra le tue richieste giorno per giorno. Sotto le chiavi, Attività recenti in background elenca le attività avviate dalle tue chiavi, con il loro stato (In attesa, In corso, Fatto o Fallita), quanto tempo hanno richiesto e quanto sono contate.
La documentazione dell'API e il playground
La documentazione completa è nella pagina FeedBro API. Ci arrivi dal link documentazione API nelle Impostazioni, oppure da API per sviluppatori in fondo a ogni pagina. Descrive ogni richiesta, con risposte di esempio e tutti i messaggi di errore. La pagina è in inglese, come le risposte dell'API, quindi qui i suoi pulsanti e i messaggi di errore sono indicati in inglese.
La pagina ha un playground chiamato Try it, dove puoi provare le richieste senza scrivere codice:
- Incolla la tua chiave nella casella API key. Mentre scrivi resta nascosta; il pulsante con l'occhio la mostra.
- Scegli una richiesta dall'elenco Call, per esempio GET /summary/unread-count. La riga sotto dice cosa fa, se richiede il Coffee Club e quanto conta.
- Compila i campi che compaiono. I campi con * sono obbligatori.
- Fai clic su Send. La risposta compare sotto, con il suo stato e quante richieste ti restano.
- Fai clic su Copy as curl per copiare la stessa richiesta come comando da eseguire in un terminale.
Le richieste del playground sono reali: usano il tuo account e contano nel tuo piano. La chiave non viene salvata da nessuna parte e resta nella casella solo finché non lasci la pagina. Se usi Postman (uno strumento molto diffuso per provare le API), la pagina ha anche Download the Postman collection.
Un primo esempio a parole
Ogni richiesta va a un indirizzo che inizia con https://feedbro.com/api/v1 e porta la tua chiave in un'intestazione chiamata Authorization, nella forma Bearer seguito da uno spazio e dalla chiave. Per esempio, un programma che chiede GET /summary/unread-count riceve un solo numero, quanti articoli non letti hai in tutti i tuoi feed, più l'ora in cui è stato calcolato. Un programma che chiede GET /articles con filter=unread riceve i tuoi articoli non letti, 25 alla volta, dal più recente. Ognuno arriva con titolo, link, riassunto, immagine e l'indicazione se è letto, salvato o in Da leggere dopo.
Leggere un articolo con una chiave non lo segna come letto in FeedBro. L'API inoltre non fa mai aspettare il tuo programma mentre recupera un sito. Risponde con quello che FeedBro ha già, e tutto ciò che va recuperato parte come attività in background.
Buono a sapersi
- Tratta una chiave API come una password, perché chi ce l'ha può leggere il tuo account. Non incollarla mai in una pagina pubblica e non mostrarla in uno screenshot.
- Se un'app capisce solo l'RSS, non ti serve nessuna chiave. Usa invece i tuoi link RSS.
- I link RSS e le chiavi API sono separati. Reimpostare i link RSS non tocca le chiavi, e revocare una chiave non tocca i link.
Se qualcosa non funziona
"Unauthenticated."
La chiave manca, è scritta male o è stata revocata. Controlla l'intestazione Authorization, oppure crea una nuova chiave.
"On the Free plan an API key can read only." oppure "Background jobs and webhooks are part of Coffee Club."
La richiesta richiede il Coffee Club.
"Too many requests this minute. Wait a moment and try again."
Il tuo programma manda richieste troppo in fretta. Aspetta i secondi indicati nella risposta, poi riprova.
"Monthly limit reached" (piano Free) o il limite giornaliero (Coffee Club)
Hai esaurito le richieste fino alla data di azzeramento indicata nella risposta e nel riquadro Utilizzo.
"Il piano gratuito include 1 chiave API. Coffee Club ne consente fino a 5." oppure "Puoi avere fino a 5 chiavi. Revocane prima una."
Revoca una chiave che non usi più prima di crearne una nuova.
La mia app RSS ha smesso di aggiornarsi
Se hai fatto clic su Reimposta i link, i vecchi link non funzionano più. Copia quelli nuovi da Impostazioni, scheda Feed.
Il link RSS della mia raccolta mostra un solo elemento sul Coffee Club
I link delle raccolte richiedono il Coffee Club. Il link Salvati funziona con ogni piano.
Il mio articolo salvato non è ancora nell'app RSS
I link si aggiornano al massimo ogni 15 minuti con il piano Free e ogni 5 minuti con il Coffee Club, e la tua app RSS controlla con i suoi tempi. Aspetta un po' e ricontrolla.
