Funktionen des Atom-APIs

(Auszug aus "Newsfeeds mit RSS und Atom" von Heinz Wittenbrink, erschienen bei Galileo Press, 2005)

Finden von Einträgen

Die erste Grundfunktion des APIs besteht darin, einzelne Einträge oder Gruppen von Einträgen zu finden. Ein entsprechender URI ist im Introspektionsdokument angegeben. Über diesen URI können Dokumente gefunden werden, die Gruppen (collections) von Einträgen beschreiben.

Bearbeiten von Einträgen über den EditURI

Jeder Eintrag besitzt einen spezifischen URI, über den er bearbeitet werden kann, den EditURI. In Listen von Einträgen ist auch dieser URI enthalten; er wird auch nach der Erzeugung eines neuen Eintrags zurückgegeben. Wie die Benennung erfolgt, ist Sache der Server-Software. Ein Client wird im Introspektionsdokument über diesen URI informiert.

Bearbeiten einer Gruppe von Einträgen über den FeedURI

Der FeedURI, der zum Bearbeiten verwendet wird, dient zum Herunterladen eines Atom-Feeds, der sich von einem "gewöhnlichen" Feed durch Links unterscheidet, die von jedem Eintrag zum jeweils vorangehenden und folgenden führen und die Bearbeitung erleichtern. Außerdem kann der Feed ein Link-Element mit rel="service.post" enthalten, über das neue Einträge an den Server geschickt werden können. Jeder einzelne Eintrag sollte ein Link mit rel="service.edit" enthalten, dessen URIs EditURIs sind.

Der service.feed ist die Introspektionsdatei, in der der Funktionsumfang des Servers publiziert wird. Die verschiedenen Facetten, die der Service bietet, werden über Link-Elemente gefunden. Bei diesen Links beginnt der Wert des Attributs rel mit der Zeichenkette service; darauf folgt der Name des jeweiligen Services. Es gibt auch keinen eigenen Suchservice mehr, sondern Links, die auf andere Feeds zeigen, die entweder rel="service.feed" und verschiedene Titel haben oder aber einfach mit rel="prev" oder rel="next" auf vorangehende oder folgende Feeds hinweisen.

Posten von anderen Daten über ResourcePostURI

Der ResourcePostURI dient dazu, Ressourcen, die keine Einträge sind, an den Server zu schicken. Dieser URI wird wiederum über Links gefunden. Diese Links gehören entweder zum Kopf eines HTML-Dokuments oder sie sind Kinder eines Elements atom:feed oder atom:entry. Der Link hat ein Attribut rel="resource.post". Zu dem HTTP-Request, der an den Server geschickt wird, gehören ein Content-Type- und ein Content-Length-Header. Der Server antwortet mit den üblichen HTTP-Response-Codes.

   

<< zurück vor >>

 

 

 

Tipp der data2type-Redaktion:
Zum Thema Newsfeeds mit RSS und Atom bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: