Methode
Die Abfrage der Daten ist sowohl per GET als auch per POST möglich.
Der API-Token muss in jeder Anfrage mit dem Namen ‘token’ mitgeschickt werden.
Zusätzlich angegeben werden können:
- ‘begin’ Format: YYYY-MM-DD | Standardwert: Heute
- ‘end’ Format: YYYY-MM-DD | Standardwert: = ‘begin’
- ‘number’ Format: int | Standardwert: 3
- ‘begin’, ‘end’ : Es sind ausschließlich Abfragen vom Vortag beginnend bis maximal 7 Tage in die Zukunft möglich
- ‘number’ : Bestimmt die maximale Anzahl an Diensten pro Tag an die zurückgegeben werden soll.
Beispiel für die Implementierung einer POST Anfrage mittels PHP und cURL:
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.lakt.de/api');
curl_setopt($ch, CURLOPT_HTTPHEADER, []);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'number=1&begin=2020-07-02&end=2020-07-02&token=...');
$response = curl_exec($ch);
curl_close($ch);
var_dump($response);
?>
Die gleiche Abfrage per GET: https://www.lakt.de/api?begin=2020-08-03&end=2020-08-05&number=2&token=…
Zurückgegeben wird eine Liste von Diensten im XML-Format:
- NAME: Name der Apotheke
- STREET: Straße inkl. Hausnummer
- ZIP: PLZ
- CITY: ORT
- LAT: Breitengrad
- LNG: Längengrad
- PHONE: Telefonnummer der Apotheke
- DTSTART: Dienstbeginn
- DTEND: Dienstende
Beispiel einer Rückgabe:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VCALENDAR>
<VEVENT>
<FID>259</FID>
<NAME>Alte Apotheke</NAME>
<STREET>Greizer Str. 9</STREET>
<ZIP>07937</ZIP>
<CITY>Zeulenroda-Triebes | OT Zeulenroda</CITY>
<LAT>50.648135</LAT>
<LNG>11.981243</LNG>
<PHONE>0800-3432768</PHONE>
<URL></URL>
<NDID>540646</NDID>
<DTSTART>2020-06-30T08:00:00</DTSTART>
<DTEND>2020-07-01T08:00:00</DTEND>
</VEVENT>
</VCALENDAR>Für die Weiterverarbeitung der Rückgabe zur Darstellung auf Ihrer Webseite können Sie bei Umsetzung mit PHP beispielsweise SimpleXML verwenden.
Siehe: https://www.php.net/manual/de/simplexml.examples-basic.php