Termine über Datenschnittstelle (JSON) abrufen, z.B. für die Homepage Deiner Location

Daten Schnittstelle (API) für Veranstaltungen

Beispiele für die Einbindung unserer Termine

Im folgenden zeigen wir, wie man Termine auf seiner Webseite/.. auf einfache Weise einbinden kann, und dabei auch das Layout sehr genau an seine Bedürfnisse anpassen kann. Auch eine Filterung der Termine ist sehr beliebig möglich.

Diese Seite ist für Webentwickler gedacht, und demonstriert die Flexibilität unserer Schnittstelle. Die Beispiele sollen einfach zu verstehen sein, daher haben wir überflüssiges weggelassen, wodurch sie nicht unbedingt hübsch aussehen. Wir unterstützen Dich gerne bei der Anpassung an Dein Design.

Die unten aufgeführten Beispiele kannst Du direkt in einer beliebigen PHP-Seite auf deinem Webspace einbauen und sind für Veranstalter/Locations kostenlos. Im ersten Beispiel brauchst Du einen Account bei uns, den wir für den Export freigeschaltet haben müssen (E-Mail an uns, siehe Konditionen), die Mailadresse und das Passwort kannst Du dann oben eintragen und los gehts. Im zweiten Beispiel reicht es aus, wenn Du Webadministrator einer der bei uns aufgeführten Locations bist. Die ID deiner Location bekommst Du z.B. heraus, indem Du diese oben im Suchfeld suchst und auf eine Seite mit einer Adresse wie etwa

https://www.wasgehtapp.de/location.php?id=53

gelangst. In diesem Fall ist 53 die ID. Diese brauchst Du dann nur noch im Code unten eintragen, etwa

... "locations"=> array(53), ..

Zuerst einmal ein Beispiel in PHP (auch andere Programmiersprachen möglich)

Dieses Beispiel zeigt die nächsten Termine (7 Tage) der Pumpe (ID=7) und des Ben Briggs (ID=12587) an. Das Design unten kannst Du völlig frei in HTML anpassen. Frag uns, damit wir Deinen Account zum Testen für den Export freischalten.

PHP/HTML-Code

<?
$WASGEHTAPP_USER = "DEINE MAILADRESSE";
$WASGEHTAPP_PASS = "DEIN WASGEHTAPP.DE-PASSWORT";

// Eine kleine Hilfsfunktion für die HTTP Anfrage
function httpPost($url,$post){

	$postdata = http_build_query($post);

	$agent = "Wasgehtapp-Example-Importer"; //hier bitte Deinen Namen/Firma eintragen

	$context = stream_context_create(array(
		'http'=>array(
				'method'=>'POST',
				'protocol_version'=> 1.1,
				'header'=> 'User-Agent: '.$agent.'\r\nConnection: close\r\nContent-Type: application/x-www-form-urlencoded\r\nContent-Length: '.strlen($postdata).'\r\n',
				'content' => $postdata
			)
		)
	);

	return file_get_contents($url,false,$context);
}

// Hier legst Du fest, welche Termine (Locations/Kategorien/Tags..) Du einbetten willst:
$termine = httpPost("https://www.wasgehtapp.de/export.php",
	array(
		"mail"=>$WASGEHTAPP_USER,
		"passwort"=>$WASGEHTAPP_PASS,
		"locations"=> "7,12587",
		"columns" => "bild_s",
		"kategorien" => "disco,konzert",
		"datum_start" => strftime("%Y-%m-%d",time()),
		"datum_ende" => strftime("%Y-%m-%d",time() + 86400 * 7),
	)
);


$termine = json_decode($termine);
// so..fertig..nun kommt die Ausgabe der Liste auf deine Webseite:

?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8"/>
<style>
body {background:#eee;}
</style>
</head>
<body>

<? if ($termine->error){?>

	Ein Fehler ist aufgetreten: <?=$termine->error?>

<?} elseif (!count($termine->data)){?>

	Keine Termine gefunden!

<?} else {?>
	<table border="1">
	<?foreach ($termine->data as $termin){?>
		<tr>
		<td><?if ($termin->bild_s){?><img src="<?=$termin->bild_s?>"/><?}?></td>
		<td>
			<?=$termin->titel?><br/>
			<?=$termin->datum?>
			<?=$termin->zeit?>
			
			<?=$termin->location?><br/>
		</td>
		</tr>
	<?}?>
<?}?>

</body>
</html>

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Und noch ein Beispiel in PHP für die Termine einer Location

Dieses Beispiel zeigt die nächsten Termine der Pumpe (ID=7) an. Das Design unten kannst Du völlig frei in HTML anpassen. Wie Du siehst, ist hier der Hintergrund dunkel, und es werden keine Bilder, dafür aber die Detailtexte angezeigt. Wenn Du dieses Beispiel auf der Webseite deiner Location einbindest, und die Termine dieser Location anforderst, ist sogar keine Authentifizierung notwendig.

PHP/HTML-Code

<?

function httpPost($url,$post){

	$postdata = http_build_query($post);

	$agent = "Wasgehtapp-Example-Importer"; //hier bitte Deinen Namen/Firma eintragen

	$context = stream_context_create(array(
		'http'=>array(
				'method'=>'POST',
				'protocol_version'=> 1.1,
				'header'=> 'User-Agent: '.$agent.'\r\nConnection: close\r\nContent-Type: application/x-www-form-urlencoded\r\nContent-Length: '.strlen($postdata).'\r\n',
				'content' => $postdata
			)
		)
	);

	return file_get_contents($url,false,$context);
}


$termine = httpPost("https://www.wasgehtapp.de/export.php",
	array(
		"locations"=> "7",
		"columns" => "beschreibung"
	)
);

$termine = json_decode($termine);

?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8"/>
<style>
body {background:#003;color:white;font-size:12px;font-family:arial;}
a {color:#aaf;}

</style>
</head>
<body>

<? if (@$termine->error || !count($termine->data)){?>
<?=$termine->error?>
	Keine Termine gefunden!

<?} else {?>
	<?foreach ($termine->data as $termin){?>
		<?=$termin->datum?>,
		<?=$termin->zeit?> Uhr, <?=$termin->titel?></h3>
		<div><?=$termin->beschreibung?></div>
		<hr/>
	<?}?>
<?}?>

</body></html>

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Technisches

Die Einbettung ist über einen JSON Webservice realisiert, d.h. Du bekommst die Termine im Format:

{
"data": [
{
"id": "3134",
"titel": "Orgel klassisch",
"datum_iso": "2011-07-06",
"zeit": "17:00",
"location": "St. Nikolai-Kirche"
},
{
"id": "2765",
"titel": "Noise and Resistance",
"datum_iso": "2011-07-06",
"zeit": "18:30",
"location": "Pumpe"
},...

Url: https://www.wasgehtapp.de/export.php

Authentifizierung: Post-Parameter "mail" und "passwort" mit deinen Account-Zugangsdaten

Mögliche Ausgabe-Felder:

Feld	Beschreibung
id	Event-ID
art	Falls art=regel ist, sollte ein Hinweis angezeigt werden, dass es unsicher ist, ob die Regel noch gilt. Hier sind Hinweise auf veraltete Einträge erwünscht.
titel	Titel
datum	Datum (dd.mm.yyyy)
datum_iso	Datum (yyyy-mm-dd)
zeit	Zeit (hh:mm)
location	Location Name
kategorie	Kategorie (konzert, disco, literatur, comedy, theater, vortrag, sport, medien, sonstige, kunst, kino)

bild_s	Miniatur Vorschau Bild (50px)
bild	Vorschau Bild
subtitel	Subtitel
beschreibung	Beschreibung (ggf. mit html-Tags)
ort	Location Ort
plz	Location PLZ
strasse	Location Adresse (Strasse + Nr)
location_url	Location Homepage
location_bild	Location Bild/Logo
location_id	Location ID
sublocation	Raum innerhalb der Location
lat	Geokoordinate Latitude
lng	Geokoordinate Longitude
url	Link zur Details/Quelle
youtube	Youtube-ID
groupid	Gruppierung für Reihen bzw Kinofilme

Es werden grundsätzlich folgende Felder ausgegeben: id, titel, datum, datum_iso, zeit, location, kategorie.

Alle zusätzlichen Felder (siehe oben) können über den "columns" Parameter (komma-separiert) angefordert werden.

Mögliche Filter (Request-Parameter) sind kategorien (komma-separiert), locations (komma-separiert), lat, lng, radius (km), zeit (ab HH:MM), datum_start und datum_ende (YYYY-MM-DD)

Das Ergebnis ist auf 500 Termine pro Abfrage limitiert, und muss sonst auf mehrere Abfragen aufgeteilt werden (z.B. Datumsbeschränkung)

Falls es mit dem Zugriff Probleme geben sollte, insbesondere für Bilder, und für weitere Details und Fragen schreib uns einfach eine E-Mail.

Nutzungsbedinungen

Es gelten unsere AGB
Die Daten dürfen nicht woanders gespeichert werden, sondern nur LIVE genutzt werden
Der Service ist jederzeit von beiden Seiten mit einer Frist von 30 Tagen kündbar
Bei Nutzung der JSON Schnittstelle auf Webseiten ist gut sichtbar unser verlinktes Logo
powered by www.wasgehtinkiel.de
einzublenden.
Abweichende Regelungen können vereinbart werden

Daten Schnittstelle (API) für Veranstaltungen

Beispiele für die Einbindung unserer Termine

Zuerst einmal ein Beispiel in PHP (auch andere Programmiersprachen möglich)

PHP/HTML-Code

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Und noch ein Beispiel in PHP für die Termine einer Location

PHP/HTML-Code

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Technisches

Nutzungsbedinungen

Allgemein

API / Datennutzung

Für Veranstalter / Locations

Rechtliches

Umkreis festlegen

Standort bestimmen

Stadt suchen

Städte:

Daten Schnittstelle (API) für Veranstaltungen

Beispiele für die Einbindung unserer Termine

Zuerst einmal ein Beispiel in PHP (auch andere Programmiersprachen möglich)

PHP/HTML-Code

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Und noch ein Beispiel in PHP für die Termine einer Location

PHP/HTML-Code

Und so kann das obige Beispiel dann aussehen (hier eingebettet in einen IFRAME):

Technisches

Nutzungsbedinungen

Allgemein

API / Datennutzung

Für Veranstalter / Locations

Rechtliches