Flux RSS & Atom

Quelques informations de spécification sur les flux RSS et Atom

RSS 2.0

Exemple avec le minimum requis :

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
<channel>
  <title>Titre du flux</title>
  <description>Voici une courte description du flux</description>
  <link>http://www.example.com/</link>
  <item>
    <title>Titre de l'élément</title>
  </item>
</channel>
</rss>

Note : les colonnes “Requis” et “Multiple” sont à revérifier dans la doc pour RSS.

Informations de flux (dans <channel>) :

Noeud	Requis	Multiple	Règles
title	Oui
link	Oui
description	Oui
language
copyright
managingEditor
webMaster
generator
pubDate
lastBuildDate
category
docs
cloud
ttl
image
rating
textInput
skipHours
skipDays
item	Oui	Oui	voir tableau ci-dessous

Informations d'élément de flux (dans <item>) :

Noeud	Description	Requis	Règles
title		optionnel	requis si pas de “description”
description		optionnel	requis si pas de “title”
link		optionnel
author		optionnel	“should” be an email
category		optionnel
comments	URL page de commentaires	optionnel
enclosure	podcasts	optionnel	attributs requis : url, length, type
guid		optionnel	unique. peut être un lien. si isPermalink=“true”, alors ???
pubDate		optionnel	format de date RSS
source	indique le flux source	optionnel

Sources :

Atom

Exemple avec le minimum requis :

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6</id>
  <title>Titre du flux</title>
  <updated>2013-09-06T16:14:00Z</updated>
  <entry>
    <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
    <title>Atom-Powered Robots Run Amok</title>
    <updated>2003-12-13T18:30:02Z</updated>
    <link rel="alternate" type="text/html" href="http://www.example.com/article-path"/>
    <summary>Résumé de l'article</summary>
    <author>
      <name>John Doe</name>
      <email>johndoe@example.com</email>
    </author>
  </entry>
</feed>

Informations de flux (dans <feed>) :

Noeud	Requis	Multiple	Règles
id	Oui
title	Oui
updated	Oui
author			requis si certains éléments n'en comporte pas
link[rel=“self”]			recommandé
link[rel=“alternate”]
link		Oui
subtitle
rights
category		Oui
generator
icon
logo
contributor		Oui	même forme que “author”
entry	Oui	Oui	voir tableau ci-dessous

Informations d'élément de flux (dans <entry>) :

Noeud	Description	Requis	Multiple	Règles
id		Oui
title		Oui
updated		Oui
link[rel=“alternate”]				requis si pas de “content”. unique pour un couple d'attributs type & hreflang
link			Oui
summary				requis si <content src=“…”> ou content de type média (base64)
author				requis ici si absent des infos générale du flux
contributor			Oui	même forme que “author”
category			Oui
content
published
rights
source	indique le flux source

Informations d'une personne (dans les <author> et les <contributor>) :

Noeud	Description	Requis	Multiple	Règles
name		Oui
uri
email

Sources :

Documentation d'Atom

Correspondance RSS/Atom

Correspondance entre les champs d'un flux Atom et ceux d'un flux Rss.

Informations de flux :

Atom	Requis	Rss	Requis
title	Oui	title	Oui
entry	Oui	item	Oui
id	Oui
updated	Oui	pubDate, lastBuildDate
link		link	Oui
subtitle		description	Oui
author, contributor		managingEditor, webMaster
right		copyright
generator		generator
category		category
icon, logo		image
		language
		docs
		cloud
		ttl
		rating
		textInput
		skipHours
		skipDays

Informations d'élément de flux :

RSS	Atom	Requis	Remarque
	id	Oui
title	title	Oui
description	summary
	content
link	link		Atom : Multiple
	link[rel=“alternate”]
author	author
category	category		Atom : Multiple
pubDate	published
pubDate	updated	Oui
source	source
giud
comments
enclosure
	contributors		Atom : Multiple
	rights