URL: http://hoersuppe.de/api/ Original Doku: http://hoersuppe.de/feature/api.txt
Der Aufruf erfolgt über den URL und angehangene Parameter. Wichtigster Parameter ist die action, die bestimmt, was gefragt und zurückgegeben wird. Die zurückgegebenen Daten enthalten immer einen Status, eine Meldung und bei Erfolg die zurückgegebenen Daten. Folgende Aktionen sind möglich:
getPodcasts
{
"status":1,
"msg":"ok",
"data":[
{
"title":"\/dev\/radio",
"slug":"devradio"
},
{
"title":"1337kultur",
"slug":"1337kultur"
},
{
"title":"Alternativlos",
"slug":"alternativlos"
}
// ...
]
}
getPodcastData
podcast
: Podcast-Slug (erforderlich){
"status":1,
"msg":"ok",
"data":
{
"ID":2598,
"title":"Wrint",
"description":"Wer redet ist nich tot",
"url":"http:\/\/www.wrint.de","
feedurl":"http:\/\/feeds.feedburner.com\/wrint\/",
"imageurl":"http:\/\/www.wrint.de\/wp-content\/uploads\/powerpress\/wrint_basis_weiss_1400.jpg",
"slug":"wrint",
"recension":"",
"cluster":"Berlin",
"rec_pos":"Interessante Interviews mit fern und nah lebenden Menschen, spannende Biografien und eine Talksendung mit H\u00f6rerfragen gibt's hier im Paket mit professioneller Arbeit.",
"rec_neg":"Wie soll ich das nun formulieren? Es soll Menschen geben, die mit Holgers \"Meinungsst\u00e4rke\" nicht zurechtkommen. Zart besaitete Freunde der Hom\u00f6opathie sollten nicht reinh\u00f6ren.",
"chat_server":"irc.freenode.net",
"chat_channel":"kleitung\n",
"chat_url":"http:\/\/webchat.freenode.net\/?channels=kleitung\n",
"obsolete":"",
"freeze":"",
"rundfunk":"",
"otitle":"WRINT",
"contact":
{
"twitter":"wrint_de",
"adn":"holgi",
"email":"mail@wrint.de"
},
"feature":"0"
}
}
getPodcastLive
podcast
: Podcast-Slug (erforderlich)count
: Limitiert die Ausgabe auf die nächsten count
Livetermine (optional){
"status":1,
"msg":"ok",
"data":[
{
"id":"2948",
"podcast":"wrint",
"state":"1",
"type":"0",
"synced":"1",
"title":"Wrint - Wrintheit",
"url":"http:\/\/www.wrint.de\/",
"streamurl":"http:\/\/streams.xenim.de\/wrint.mp3",
"livedate":"2012-12-02 13:00:00",
"duration":"90",
"twittered":"0"
},
{
"id":"2426",
"podcast":"wrint",
"state":"1",
"type":"0",
"synced":"1",
"title":"Wrint - Realit\u00e4tsabgleich",
"url":"http:\/\/www.wrint.de\/",
"streamurl":"http:\/\/streams.xenim.de\/wrint.mp3",
"livedate":"2012-12-05 11:30:00",
"duration":"90",
"twittered":"0"
}
]
}
getPodcastEpisodes
podcast
: Podcast-Slug (erforderlich)count
: Limitiert die Ausgabe auf die letzten count
Episoden (optional, default: 10
){
"status":1,
"msg":"ok",
"data":[
{
"ID":43803,
"post_date":"2012-11-28 12:20:19",
"post_date_gmt":"2012-11-28 11:20:19",
"post_title":"WR127 Realit\u00e4tsabgleich: Arbeit schade",
"post_name":"wr127-realitatsabgleich-arbeit-schade",
"post_modified":"2012-11-28 12:20:19",
"post_modified_gmt":"2012-11-28 11:20:19",
"post_link":"http:\/\/www.wrint.de\/2012\/11\/28\/wr127-realitatsabgleich-arbeit-schade\/",
"post_commentlink":"http:\/\/www.wrint.de\/2012\/11\/28\/wr127-realitatsabgleich-arbeit-schade\/#comments",
"post_mediaurl":"http:\/\/wrint.de\/download\/WR127_Realitaetsabgleich_Arbeit_schade.mp3",
"post_duration":"2630"
}
]
}
getDeleted
dateStart
: erstes abzufragendes Datum (optional, YY-mm-dd
)dateEnd
: letztes abzufragendes Datum (optional, YY-mm-dd
){
"status":1,
"msg":"ok",
"data":[
{
"event_ID":"7712",
"deldate":"2014-04-07 15:23:00"
},
{
"event_ID":"7719",
"deldate":"2014-04-07 22:11:38"
}
]
}
getLive
count
: Limitiert die Ausgabe auf die nächsten count
Livetermine (optional)dateStart
: erstes abzufragendes Datum (optional, YY-mm-dd
)dateEnd
: letztes abzufragendes Datum (optional, YY-mm-dd
){
"status":1,
"msg":"ok",
"data":[
{
"id":"1494",
"podcast":"fanb0ys",
"state":"1",
"type":"0",
"synced":"1",
"title":"fanb0ys",
"url":"http:\/\/fanboys.fm",
"streamurl":"http:\/\/streams.xenim.de\/fanboys.mp3",
"livedate":"2012-12-07 16:00:00",
"duration":"90",
"twittered":"0"
},
{
"id":"2912",
"podcast":"knorkpod",
"state":"1",
"type":"0",
"synced":"1",
"title":"KNORKPod",
"url":"http:\/\/knorkpod.moepmoep.com\/",
"streamurl":"http:\/\/moep1.moepmoep.com",
"livedate":"2012-12-07 18:30:00",
"duration":"90",
"twittered":"0"
}
]
}
getLiveByID
ID
: die ID eines Liveevents{
"status":1,
"msg":"ok",
"data":[
{
"id":"3019",
"podcast":"binaergewitter",
"state":"1",
"type":"0",
"synced":"1",
"title":"Bin\u00e4rgewitter-Talk",
"url":"http:\/\/blog.binaergewitter.de\/",
"streamurl":"http:\/\/streams.xenim.de\/binaergewitter.mp3.m3u",
"livedate":"2013-05-23 19:30:00",
"duration":"180",
"twittered":"0"
}
]
}
action: getLastEpisodes
Parameter:
count
: Anzahl der Episoden (optional, default=10)Beschreibung: Gibt die letzten Episoden aus, die in der Hörsuppe angekommen sind.
Beispiel: http://hoersuppe.de/api/?action=getLastEpisodes&count=2
{
"status":1,
"msg":"ok",
"data":[
{
"ID": 98946,
"post_date": "2014-07-01 12:13:37",
"post_date_gmt": "2014-07-01 10:13:37",
"post_title": "SiM #665 - Der Arbeits-Rant",
"post_name": "sim-665-der-arbeits-rant",
"post_modified": "2014-07-01 12:13:37",
"post_modified_gmt": "2014-07-01 10:13:37",
"post_content_filtered": "",
"post_link": "",
"post_commentlink": "",
"post_mediaurl": "http:\/\/traffic.libsyn.com\/schlaflos\/sim665.mp3",
"post_duration": "",
"post_content": "Neue Folge, die 665te",
"episode_guid": "podlove-driven-guid-2014",
"podcast": "sim"
},
{
"ID": 98945,
"post_date": "2014-07-01 09:26:53",
"post_date_gmt": "2014-07-01 07:26:53",
"post_title": "OSMDE036 OSM Talk: Die OpenRailwayMap",
"post_name": "osmde036-osm-talk-die-openrailwaymap",
"post_modified": "2014-07-01 09:26:53",
"post_modified_gmt": "2014-07-01 07:26:53",
"post_content_filtered": "",
"post_link": "http:\/\/podcast.openstreetmap.de\/2014\/07\/01\/osmde036-osm-talk-die-openrailwaymap\/",
"post_commentlink": "",
"post_mediaurl": "http:\/\/audio.podcast.openstreetmap.de\/OSMDE036.mp3",
"post_duration": "5123",
"post_content": "Neue Folge, die 666te",
"episode_guid": "podlove-driven-guid-201134",
"podcast": "radio-osm"
}
]
}