Você pode usar a sua leitura do FeedBro em outros apps e ferramentas de duas formas. Os links RSS transformam seus artigos Salvos, ou uma coleção, em um feed que qualquer app de RSS ou ferramenta de automação consegue ler, sem nenhuma configuração. A API para desenvolvedores permite que seus próprios scripts e apps leiam seus feeds e artigos e, no Coffee Club, também os marquem como lidos ou salvos.
Sua leitura em links RSS
Um feed RSS é uma lista dos artigos mais recentes que os apps conseguem consultar para ver se há novidades. O FeedBro oferece links RSS privados para as suas próprias listas:
- Salvos: os artigos que você salvou no FeedBro. Todos os planos têm este link.
- Um link para cada coleção, com os artigos mais recentes de todos os feeds daquela coleção. Isso faz parte do Coffee Club.
Você pode usá-los para mandar seus artigos salvos para outro app leitor, um serviço de "ler depois", um chat da equipe ou uma ferramenta de automação que entenda RSS.
Como copiar seus links RSS
- Entre em feedbro.com e abra Configurações (no menu que fica sob a sua foto de perfil).
- Clique na aba Feeds.
- Procure o cartão Sua leitura em RSS.
- Ao lado de Salvos (e, no Coffee Club, ao lado do nome de cada coleção), clique em Copiar. O botão muda para Copiado por um instante. Você também pode clicar dentro do campo para selecionar o link.
- Cole o link no outro app, no lugar onde ele pede o endereço de um feed.
No plano Free, suas coleções aparecem com um cadeado e o aviso "Os links de coleções fazem parte do Coffee Club." No Coffee Club, se você ainda não tem coleções, o cartão diz "Crie uma coleção para ter também um link RSS dela."
O que vem em cada item
- O título do artigo e um link para o artigo original no site de quem o publicou.
- O resumo curto que o próprio feed publicou (até uns 600 caracteres), quando existe.
- A data de publicação.
O texto completo que o FeedBro buscou não é incluído. O outro app abre a página original quando você clica em um item.
Limites de cada plano
No Free você tem só o link de Salvos, com os seus 20 últimos artigos salvos. Ele é atualizado no máximo a cada 15 minutos.
No Coffee Club você tem o link de Salvos e um link para cada coleção, com 50 artigos cada. Eles são atualizados no máximo a cada 5 minutos.
Se você sair do Coffee Club, os links das coleções continuam abrindo, mas o app de RSS mostra apenas um item com o aviso "Os links de coleções fazem parte do Coffee Club."
Mantenha os links privados
Os links têm um código secreto e funcionam sem login, para que outros apps consigam lê-los. Isso também quer dizer que qualquer pessoa que tenha um link consegue ler aquela lista, então guarde-os só para você.
Se um link foi compartilhado por engano:
- Abra Configurações e depois a aba Feeds.
- Em Sua leitura em RSS, clique em Redefinir links.
- Aparece a mensagem "Seus links RSS antigos não funcionam mais. Os novos estão abaixo." Copie os novos links para os apps que você ainda quer usar.
Redefinir desativa todos os links antigos de uma vez: o link de Salvos e todos os links de coleções.
A API para desenvolvedores
Uma API é um jeito de os programas conversarem diretamente com o FeedBro. Com uma chave de API pessoal (um código secreto longo que funciona como a senha de um programa), um script ou app consegue ler seus feeds, coleções, artigos e páginas salvas em JSON (um formato de texto simples que os programas leem). Ela usa a sua própria conta, então o que ela muda aparece no FeedBro, e vice-versa.
Limites de cada plano
No Free você tem 1 chave e 500 requisições por mês, até 30 requisições por minuto por chave, só para leitura.
No Coffee Club você tem até 5 chaves e 100 requisições por dia, até 60 requisições por minuto por chave. As chaves também podem marcar artigos como lidos, salvos ou para ler depois. Elas podem iniciar tarefas em segundo plano (como buscar o texto completo de um artigo ou extrair o texto principal de qualquer página da web) e enviar os resultados para um webhook (um endereço no seu próprio servidor que o FeedBro chama quando algo fica pronto).
A contagem mensal do Free recomeça no dia 1º de cada mês, e a contagem diária do Coffee Club à meia-noite UTC. A maioria das requisições conta como 1. As tarefas em segundo plano contam mais porque dão mais trabalho: buscar um artigo ou extrair uma página conta como 10, seguir um feed como 5 e começar a monitorar um site como 25. Se uma tarefa falha, ela conta como 1 e o resto é devolvido.
Como criar uma chave de API
- Abra Configurações e clique na aba API.
- No cartão Acesso à API, digite um nome para a chave no campo (por exemplo "Meu script"), para conseguir diferenciar suas chaves depois.
- Clique em Criar chave.
- A chave aparece com a mensagem "Copie esta chave agora. Ela só aparece uma vez." Clique em Copiar e guarde a chave em um lugar seguro, como um gerenciador de senhas.
Suas chaves ficam listadas no mesmo cartão, com o nome e a última vez em que foram usadas ("Ainda não usado" até a primeira requisição). Para uma chave parar de funcionar, clique em Revogar ao lado dela e confirme. Se você perder uma chave, revogue-a e crie outra.
Como ver quanto você já usou
O cartão Uso, no alto da aba API, mostra por exemplo "12 de 500 requisições este mês", quantas restam, a data em que a contagem reinicia e quantas requisições por minuto cada chave pode enviar. O gráfico Últimos 30 dias mostra suas requisições por dia. Abaixo das chaves, Tarefas recentes em segundo plano lista as tarefas que suas chaves iniciaram, com o status (Aguardando, Em andamento, Concluída ou Falhou), quanto tempo levaram e quanto contaram.
A documentação da API e o playground
A documentação completa está na página API do FeedBro. Você chega a ela pelo link documentação da API nas Configurações, ou por API para desenvolvedores no rodapé de todas as páginas. Ela cobre todas as requisições, com exemplos de resposta e todas as mensagens de erro. A página está em inglês.
A página tem um playground chamado Try it, onde você pode testar requisições sem escrever código:
- Cole sua chave no campo API key. Ela fica oculta enquanto você digita; o botão do olho a mostra.
- Escolha uma requisição na lista Call, por exemplo GET /summary/unread-count. A linha abaixo diz o que ela faz, se precisa do Coffee Club e quanto ela conta.
- Preencha os campos que aparecerem. Os campos marcados com * são obrigatórios.
- Clique em Send. A resposta aparece embaixo, com o status e quantas requisições você ainda tem.
- Clique em Copy as curl para copiar a mesma requisição como um comando que você pode rodar em um terminal.
As requisições do playground são reais: elas usam a sua conta e contam no limite do seu plano. Sua chave não fica salva em lugar nenhum e só permanece no campo até você sair da página. Se você usa o Postman (uma ferramenta conhecida para testar APIs), a página também tem Download the Postman collection.
Um primeiro exemplo em palavras simples
Toda requisição vai para um endereço que começa com https://feedbro.com/api/v1 e leva a sua chave em um cabeçalho chamado Authorization, no formato Bearer seguido de um espaço e da sua chave. Por exemplo, um programa que pede GET /summary/unread-count recebe de volta um número, quantos artigos não lidos você tem somando todos os seus feeds, e o horário em que ele foi calculado. Um programa que pede GET /articles com filter=unread recebe seus artigos não lidos, 25 de cada vez, dos mais novos para os mais antigos. Cada um vem com título, link, resumo, imagem e se está lido, salvo ou em Ler depois.
Ler um artigo por meio de uma chave não o marca como lido no FeedBro. A API também nunca deixa seu programa esperando enquanto um site é buscado. Ela responde com o que o FeedBro já tem, e o que precisa ser buscado roda como tarefa em segundo plano.
Bom saber
- Trate uma chave de API como uma senha, porque qualquer pessoa que a tenha consegue ler a sua conta. Nunca a cole em uma página pública nem a mostre em uma captura de tela.
- Se um app só entende RSS, você não precisa de chave. Use seus links RSS.
- Seus links RSS e suas chaves de API são coisas separadas. Redefinir os links RSS não afeta as chaves, e revogar uma chave não afeta os links.
Se algo não funcionar
"Unauthenticated."
As respostas da API vêm em inglês. Esta quer dizer que a chave está faltando, foi digitada errado ou foi revogada. Confira o cabeçalho Authorization ou crie uma nova chave.
"On the Free plan an API key can read only." ou "Background jobs and webhooks are part of Coffee Club."
A requisição precisa do Coffee Club.
"Too many requests this minute. Wait a moment and try again."
Seu programa está enviando requisições rápido demais. Espere os segundos indicados na resposta e tente de novo.
"Monthly limit reached" (Free) ou o limite diário (Coffee Club)
Suas requisições acabaram até a data de reinício que aparece na resposta e no cartão Uso.
"O plano grátis inclui 1 chave de API. O Coffee Club permite até 5." ou "Você pode ter até 5 chaves. Revogue uma primeiro."
Revogue uma chave que você não usa mais antes de criar outra.
Meu app de RSS parou de atualizar
Se você clicou em Redefinir links, os links antigos não funcionam mais. Copie os novos em Configurações, aba Feeds.
O link RSS da minha coleção mostra só um item sobre o Coffee Club
Os links de coleções precisam do Coffee Club. O link de Salvos funciona em todos os planos.
Meu artigo salvo ainda não aparece no app de RSS
Os links são atualizados no máximo a cada 15 minutos no Free e a cada 5 minutos no Coffee Club, e o seu app de RSS confere no ritmo dele. Espere um pouco e confira de novo.
