Apps&Co - Atom feed API

Inhalt:

Verfügbare Feeds:

1. News Feed
2. Apps Feed
3. Tipps Feed

News Feed

Die URL des News-Übersichts-Feeds lautet:

http://api.appsundco.de/news

Es sind die folgenden Abfrageparamenter erlaubt:

Parameter	Bedeutung	Standard
alt	Rückgabeformat des Feeds Mögliche Werte sind atom oder rss Derzeit werden nur beim Atom-Feed alle Elemente untstüzt	atom
max-results	Maximalanzahl von Meldungen im Feed	25
start-index	Ab welchem Index sollen Meldungen im Feed enthalten sein	1

Die URL eines einzelnen Meldung lautet:

http://api.appsundco.de/news/<news_id>

Ein einzelnes Element bzw. eine einzelne Meldung wird wie folgt zurück gegeben:

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
  <id>http://api.iphoneundmehr.de/news/438</id>
  <link rel="self" type="application/atom+xml" href="http://api.iphoneundmehr.de/news/438"/>
  <link rel="alternate" type="text/html" href="http://www.appsundco.de/40.html?&amp;no_cache=1&amp;tx_ttnews[backPid]=15&amp;tx_ttnews[tt_news]=438"/>
  <title><![CDATA[Jailbreak 3.1]]></title>
  <updated>2009-09-17T16:51:00+02:00</updated>
  <summary><![CDATA[Das Dev-Team hat w...]]></summary>
  <content><![CDATA[Das Katz-und-Maus-Spiel zwischen Apple und den Jailbreakern geht weiter...]]></content>
  <media:group>
    <media:content url="http://www.appsundco.de/uploads/pics/devteam_01.png" type="image/png" medium="image"/>
    <media:category>news</media:category>
  </media:group>
</entry>

Apps Feed

Die URL des Kategorie-Übersichts-Feeds für die Apps lautet:

http://api.appsundco.de/apps/categories

Dieser Feed liefert eine Übersicht über die im System verfügbaren Apps-Kategorien. Die einzelnen Kategorie-Elemente sehen wie folgt aus:

<?xml version="1.0" encoding="utf-8"?>
<entry>
  <id>http://api.appsundco.de/apps/categories/21</id>
  <link rel="self" type="application/atom+xml" href="http://api.appsundco.de/apps/categories/21"/>
  <link rel="alternate" type="text/html" href="http://www.appsundco.de/apps.html?&amp;no_cache=1&amp;tx_appreview_pi1[cat]=21"/>
  <title><![CDATA[Wetter]]></title>
  <updated>2008-10-12T20:17:21+02:00</updated>
</entry>

Der Self-Link enthält die URL des Kategorie-Feeds, der die besten 25 Apps dieser Kategorie enthält.

Die URL des Kategorie-Feeds für die Apps lautet:

http://api.appsundco.de/apps/categories/<category_id>/

Dieser Feed gibt die besten 25 Apps der per category_id gewählten Kategorie zurück. Die besten 25 Apps werden bestimmt, indem nach Bewertung und Änderungsdatum in absteigender Reihenfolge sortiert wird.
Es sind die folgenden Abfrageparamenter erlaubt:

Parameter	Bedeutung	Standard
alt	Rückgabeformat des Feeds Mögliche Werte sind atom oder rss Derzeit werden nur beim Atom-Feed alle Elemente untstüzt	atom
max-results	Maximalanzahl von Meldungen im Feed	25
start-index	Ab welchem Index sollen Meldungen im Feed enthalten sein	1

Ein einzelnes Element bzw. eine einzelne App wird wie folgt zurück gegeben:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xmlns:app="http://api.appsundo.de/apps">
  <id>http://api.appsundco.de/apps/1447</id>
  <link rel="self" type="application/atom+xml" href="http://api.appsundco.de/apps/1447"/>
  <link rel="alternate" type="text/html" href="http://www.appsundco.de/apps.html?&amp;no_cache=1&amp;tx_appreview_pi1[app]=1447"/>
  <title><![CDATA[GeoDefense Swarm]]></title>
  <updated>2009-09-21T00:52:15+02:00</updated>
  <summary><![CDATA[Offenbarung für Hardcore-Strategie]]></summary>
  <content><![CDATA[Das Tower-Defense-Spiel &quot;GeoDefense&quot; ist seit Anfang 2009 eines der Spiele-Highlights im AppStore – ...]]></content>
  <app:group>
    <app:rating>4</app:rating>
    <app:summary><![CDATA[Das neue "GeoDefense" beschäftigt uns seit Tagen, und das für läppische 79 Cent. Wer anspruchsvolle Tower-Defense-Games mag, MUSS zugreifen!]]></app:summary>
    <app:freebie>false</app:freebie>
    <app:new>true</app:new>
    <app:price><![CDATA[0,79]]></app:price>
    <app:version><![CDATA[1.0.5]]></app:version>
    <app:author><![CDATA[Critical Thought Games]]></app:author>
    <app:language><![CDATA[Englisch]]></app:language>
    <app:category>10</app:category>
    <app:categoryName><![CDATA[Gesundheit und Fitness]]></app:categoryName>
    <app:imageCount>2</app:imageCount>
    <link rel="appstore" type="application/itunes" href="http://itunes.apple.com/WebObjects/MZStore.woa/wa/viewSoftware?id=326563285&amp;mt=8"/>
  </app:group>
  <media:group>
    <media:content url="http:///www.appsundco.de/uploads/tx_appreview/GeoDefense_Swarm_s.png" type="image/png" medium="image"/>
    <media:category>image</media:category>
    <media:description><![CDATA[Die Creeps greifen im Schwarm an.]]></media:description>
  </media:group>
  <media:group>
    <media:content url="http://www.appsundco.de/uploads/tx_appreview/iCrillion2_s.png" type="" medium="image"/>
    <media:category>image</media:category>
    <media:description><![CDATA[Der Ball soll alle Klötze zerstören.]]></media:description>
  </media:group>
  <media:group>
    <media:content url="http://www.appsundco.de/uploads/tx_appreview/iCrillion_s.png" type="" medium="image"/>
    <media:category>image</media:category>
    <media:description><![CDATA[Einige der Level sind enorm vertrackt.]]></media:description>
  </media:group>
  <media:group>
    <media:content url="http:///www.appsundco.de/uploads/tx_appreview/GeoDefense_Swarm_i.png" type="image/png" medium="image"/>
    <media:category>icon</media:category>
  </media:group>
</entry>

• Hier enthält der Self-Link einen Verweis für die einzelne App.
• Das <summary>-Element enthält den Untertitel der App.
• <content> enthält den Rezensionstext.
• Für Applikations-Bilder sowie Icon wird jeweils eine <media:group> eingefügt.
• Zur Unterscheidung dienen die <media:category>-Elemente. Für das Applikations-Bilder bzw. den Screenshot dient die Kategorie "image". Für das Applikations-Icon wird Kategorie "icon" verwendet;
• Die Bildunterschrift befindet sich (falls vorhanden) in einem <media:description>-Element.
• Alle Elemente, die nicht durch Standard-Feed-Elemente abgebildet werden können, werden unter <app:group> in einem eigenen Namensraum (http://api.appsundco.de/apps) zusammengefasst.
• <app:rating> bestimmt die Bewertung. Die Werte umfassen [1 Stern = 0, 5 Sterne = 4]
• <app:summary> enthät das vom Autor gepflegte Fazit der Rezension.
• <app:freebie> zeigt, ob die Anwendung kostenlos (freebie = true) ist, oder nicht (freebie = false).
• <app:new> zeigt, ob die Anwendung innerhalb der letzten drei Tage geändert wurde (new = true), oder nicht (new = false).
• <app:price> enthät den Preis als Zeichenkette, wie vom Autor gepflegt. Im System findet zu diesem Wert keine Prüfung (Formatierung, Plausibilität) statt.
• <app:version> enthät die vom Autor gepflegte Version der App.
• <app:author> enthät den Hersteller bzw. Programmierer der App.
• <app:author> enthät die vom Autor gepflegte Sprache der App. Im System findet zu diesem Wert keine Prüfung statt.
• <app:category> bzw. <app:categoryName> enthät die erste vom Autor zugewiesene Id bzw. den Namen der Kategorie der App. Dies muss nicht zwangsläufig die Kategorie sein, über die die Anwendung abgerufen wurde.
• <app:imageCount> enthät die Anzahl der <media:group> Elemente, die der Kategorie "image" zugeordnet sind.
  Dies Zahl enspricht der Anzahl von Screenshots, oder Grafiken, die der App zugeordnet sind. Das Icon wird nicht mitgezählt.
• <link> mit rel="appstore" enthät den vom Autor gepflegten iTunes-Link zur Anwendung im Apple AppStore.

Eine einzelne App kann ebenfalls über folgende URL abgerufen werden:

http://api.appsundco.de/apps/<app_id>/

Die Top-Apps können über folgende URL abgerufen werden:

http://api.appsundco.de/apps/top/

• Die Top Apps bilden sich aus den jeweils besten Applikationen der einzelnen Kategorien.
• Die beste Applikation einer Kategorie ist diejenige mit höchster Wertung und jüngstem Änderungsdatum.
• Ist eine Applikation mehreren Kategorien zugeordnet, wird nur die erste beachtet.
• Die einzelnen Elemente des Feeds entsprechen der obigen Beschreibung.

Tipps Feed

Die URL des Kategorie-Übersichts-Feeds für die Tipps lautet:

http://api.appsundco.de/tipps

Dieser Feed liefert eine Übersicht über die im System verfügbaren Tipps-Kategorien. Die einzelnen Kategorie-Elemente sehen wie folgt aus:

<?xml version="1.0" encoding="utf-8"?>
<entry>
    <id>http://api.appsundco.de/tipps/categories/2</id>
    <link rel="self" type="application/atom+xml" href="http://api.appsundco.de/tipps/categories/2"/>
    <link rel="alternate" type="text/html" href="http://www.appsundco.de/tipps_list.html?no_cache=1&amp;tx_ttnews[cat]=2"/>
    <title><![CDATA[System]]></title>
    <updated>2009-05-13T21:53:57+02:00</updated>
</entry>

Der Self-Link enthält die URL des Kategorie-Feeds, der die besten 25 Apps dieser Kategorie enthält.

Die URL des Kategorie-Feeds für die Tipps lautet:

http://api.appsundco.de/tipps/categories/<category_id>/

Dieser Feed gibt die neuesten 25 Tipps der per category_id gewählten Kategorie zurück. Es sind die folgenden Abfrageparamenter erlaubt:

Parameter	Bedeutung	Standard
alt	Rückgabeformat des Feeds Mögliche Werte sind atom oder rss Derzeit werden nur beim Atom-Feed alle Elemente untstüzt	atom
max-results	Maximalanzahl von Meldungen im Feed	25
start-index	Ab welchem Index sollen Meldungen im Feed enthalten sein	1

Ein einzelnes Element bzw. eine einzelner Tipp wird wie folgt zurück gegeben:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xmlns:app="http://api.appsundco.de/apps">
  <id>http://api.appsundco.de/tipps/285</id>
  <link rel="self" type="application/atom+xml" href="http://api.appsundco.de/tipps/285"/>
  <link rel="alternate" type="text/html" href="http://www.appsundco.de/tipps_single.html?&amp;no_cache=1&amp;&amp;tx_ttnews[backPid]=84&amp;tx_ttnews[tt_news]=285"/>
  <title><![CDATA[Klick: So gelingen Ihnen Fotos auf dem iPhone]]></title>
  <updated>2009-05-09T22:02:00+02:00</updated>
  <summary><![CDATA[Mit etwas Fingerspitzengefühl vermeiden Sie beim Fotografieren mit ...]]></summary>
  <content><![CDATA[Die Kamera im iPhone ist technisch nicht sehr überzeugend, lässt sich dafür aber so einfach bedienen, ...]]></content>
  <media:group>
    <media:content url="http://www.appsundco.de/uploads/pics/crop_ausloeser_01.jpg" type="image/jpeg" medium="image"/>
    <media:category>icon</media:category>
    <media:description><![CDATA[]]></media:description>
  </media:group>
  <media:group>
    <media:content url="http://www.appsundco.de/uploads/pics/ausloeser_01.jpg" type="image/jpeg" medium="image"/>
    <media:category>image</media:category>
    <media:description><![CDATA[]]></media:description>
  </media:group>
</entry>

Ein einzelner Tipp kann ebenfalls über folgende URL abgerufen werden:

http://api.appsundco.de/tipps/<tipp_id>/

© 2009 - LX networking GbR - Letzte Aktualisierung 28.09.09 durch jr