API

Die ScoutNet API featuring PfadiQL

Mit der ScoutNet API kannst du programmatisch auf die Daten von ScoutNet zugreifen. Die API ist als REST/JSON-basierter Webservice realisiert. Es gibt bereits Clients für PHP, Javascript, Python und Java.

Der ScoutNet-Navigator ist ein Beispiel was man mit der API umsetzen kann. Er ist auch zum Download verfügbar, zusammen mit dem PHP Client).

Fragen, Probleme, Mithelfen, einfach nur was zeigen? Kontaktier Mütze unter muetze(ät)scoutnet.de.

Derzeitige Funktionen

Lesezugriff auf Gruppen, URLs, Termine und Stufen. Alles mit PfadiQL durchsuchen. Freie Navigation über die Verbandsstrukturen.

Geplante Funktionen

Schreibzugriff auf Termine (und evtl. mehr). Performanceoptimierungen und technische Verbesserungen. Lesezugriff auf weitere öffentliche ScoutNet-Daten (Häuser, Zeltplätze, etc.). 

Download und mehr Infos

findest du auf den Seiten der Clients: PHP, Javascript, Python, Java,  Ruby.

Einstieg

Die Verwendung der API sieht in allen Sprachen sehr ähnlich aus, in PHP z.B. so:

Code

 

$events = scoutnet()->group(7)->events("start_date > '2016-01-22'");
foreach( $events as $event ){
 print $event->start_date .", ". $event->title . "\n";
}

 

Ergebnis

 

2016-05-26, Fronleichnamsprozession
2016-07-02, Pfarrfest Liebfrauen
2016-08-08, Sommerlager

 

Die Funktion scoutnet() verbindet sich dabei im Hintergrund mit dem ScoutNet-Server und fragt die entsprechenden Daten ab.

PfadiQL

Für gezielte Anfragen haben wir die Suchsprache PfadiQL entwickelt. Damit kannst du die Termine z.B. nach Datum oder Schlüsselwörtern filtern. Alle Leiterrunden von Stamm Gandalf (6) im Jahre 2011 erhält man so:

Code

 

$events = scoutnet()->group(6)->events(
 'start_date < "2011-12-31"
 and end_date > "2011-01-01"
 and "Leiterrunde" in keywords'
);
print count($events);

 

Ergebnis

 

19

 

PfadiQL kannst du in allen clients nutzen. Mehr Infos...

Fragen? Probleme? Anregungen? Beiträge? Oder du willst mithelfen?

Wende dich an Mütze unter info@scoutnet.de.