Publicações que um leitor consulta
O RSS (Really Simple Syndication) é um formato para distribuir atualizações de um site por meio de um documento XML. Esse documento é chamado de feed. Você adiciona seu endereço a um leitor de notícias, que consulta o conteúdo e apresenta as publicações encontradas.
No RSS 2.0, o elemento channel identifica o canal de publicação e contém os elementos item. Cada item descreve uma atualização. O site mantém o documento disponível no endereço do feed, por isso essa distribuição pode ser usada por leitores e integrações que consultam o XML.
Canal e publicação no XML
O exemplo didático abaixo mostra um canal com uma única publicação. Os endereços de example.org são ilustrativos.
<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"> <channel> <title>Notas de infraestrutura</title> <link>https://example.org/</link> <description>Publicações sobre configuração de serviços.</description> <item> <title>Configuração do serviço</title> <link>https://example.org/configuracao/</link> <description>Como conferir o arquivo usado pelo serviço.</description> </item> </channel></rss>O título dentro de channel nomeia o conjunto de publicações. Já o título dentro de item identifica a publicação individual, cujo link leva à página correspondente. A descrição desse item apresenta um resumo, então você precisa abrir o endereço para acessar o restante do texto.
O que conferir no feed gerado
A especificação RSS 2.0 exige título, link e descrição no canal. Cada item precisa ter pelo menos título ou descrição. Um XML bem formado ainda pode descumprir essas exigências, pois a sintaxe do XML e a estrutura do RSS são verificações diferentes.
Ao testar uma integração, compare o item exibido com a publicação de origem e abra seu link. Um feed válido pode conter um endereço incorreto ou um resumo desatualizado. A frequência das consultas também depende do programa que acompanha o feed, portanto uma atualização no site não significa exibição imediata em todos os leitores.
Dúvidas frequentes
Perguntas frequentes sobre RSS
- O feed precisa conter o artigo completo?
- Um item pode apresentar um resumo com link para a publicação ou conter o próprio texto. A especificação RSS 2.0 permite as duas formas.
- Todo item precisa de título e descrição?
- O RSS 2.0 exige ao menos um dos dois campos em cada item: title ou description. No canal, title, link e description são obrigatórios.
- O campo guid precisa ser um endereço?
- O guid identifica o item e pode ser uma sequência de caracteres. Quando não representa uma URL permanente, deve usar isPermaLink="false". O valor padrão desse atributo é true.
Para continuar
Recursos relacionados
Documentação
RSS Advisory Board: especificação RSS 2.0
Especifica os elementos obrigatórios do canal, os campos de cada item e o uso de identificadores no RSS 2.0.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
A orientação ao vivo pode ajudar você a revisar a leitura do XML e os links usados por uma integração com RSS.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode usar um feed RSS numa integração para consultar publicações e conferir como os campos do XML são interpretados pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.