Freifunk API: Unterschied zwischen den Versionen
(→Betrieb) |
(→Betrieb) |
||
Zeile 32: | Zeile 32: | ||
=== Betrieb === | === Betrieb === | ||
− | + | '''Freifunk Community API''' | |
Die Community API Dateien von Opennet werden über einen Konverter von [[Geronimo]] ''geronimo_freifunkcommunity.sh'' basierend auf einem JSON Template und einer statischen Konfigurationsdatei erzeugt. Dort sind die Opennet Regionen hinterlegt. Die Erstellung erfolgt nach Bedarf, z.B. wenn eine neue Opennet Region hinzugefügt werden soll oder falls sich die Freifunk API geändert hat. Kontrolle ist über http://api-viewer.freifunk.net und den API Generator unter | Die Community API Dateien von Opennet werden über einen Konverter von [[Geronimo]] ''geronimo_freifunkcommunity.sh'' basierend auf einem JSON Template und einer statischen Konfigurationsdatei erzeugt. Dort sind die Opennet Regionen hinterlegt. Die Erstellung erfolgt nach Bedarf, z.B. wenn eine neue Opennet Region hinzugefügt werden soll oder falls sich die Freifunk API geändert hat. Kontrolle ist über http://api-viewer.freifunk.net und den API Generator unter | ||
http://freifunk.net/api-generator/ möglich. | http://freifunk.net/api-generator/ möglich. | ||
− | + | '''Freifunk Nodelist API''' | |
Die Nodelist API Dateien von Opennet werden über einen Konverter von [[Geronimo]] ''geronimo_freifunknodeslist.sh'' erzeugt. Ein Cronjon läuft alle 10 Minuten. Kontrolle ist über http://www.freifunk-karte.de/debug.php möglich. Probleme können auch über https://github.com/ffansbach/de-map/issues gemeldet werden. | Die Nodelist API Dateien von Opennet werden über einen Konverter von [[Geronimo]] ''geronimo_freifunknodeslist.sh'' erzeugt. Ein Cronjon läuft alle 10 Minuten. Kontrolle ist über http://www.freifunk-karte.de/debug.php möglich. Probleme können auch über https://github.com/ffansbach/de-map/issues gemeldet werden. |
Version vom 17. Januar 2016, 08:30 Uhr
Team |
Freifunk API |
Treffen: nur bei Bedarf |
Freifunk API |
Mitglieder: Lars, Martin G., Mahias M. |
Kontakt: admin@opennet-initiative.de |
Inhaltsverzeichnis |
Vorbemerkung
Die Freifunk API dient dem gemeinsamen Datenaustausch zwischen allen Freifunk Communities. Darauf aufbauend werden gemeinsame Dienste wie Community Übersicht und Karten bedient. Derzeit gibt es zwei API Bestandteile:
- Freifunk Community API
- Generator: http://freifunk.net/api-generator/
- Quellen und Verwaltung: https://github.com/freifunk/api.freifunk.net
- Anzeige: http://freifunk.net/wie-mache-ich-mit/community-finden/ (http://api-viewer.freifunk.net)
- Freifunk Nodelist API
- Generator: via Export aus Geronimo Nodes API
- Quellen und Verwaltung: https://gist.github.com/StilgarBF/c21826994b775787f739
- Anzeige: http://www.freifunk-karte.de
Einrichtung
Auf Server/on-v6 stellen wir unsere JSON Dateien im API File Format bereit:
https://www.opennet-initiative.de/freifunk/
- Freifunk Community API: https://www.opennet-initiative.de/freifunk/api.freifunk.net-<opennet-region>.json
- Freifunk Nodelist API: https://www.opennet-initiative.de/freifunk/api.freifunk.net-nodelist.json
Die Nodelist API URL ist als "nodeMaps" Eigenschaft in der Community API Datei für Rostock eingebunden und liefert gleichzeitig alle anderen Regionen aus.
Betrieb
Freifunk Community API
Die Community API Dateien von Opennet werden über einen Konverter von Geronimo geronimo_freifunkcommunity.sh basierend auf einem JSON Template und einer statischen Konfigurationsdatei erzeugt. Dort sind die Opennet Regionen hinterlegt. Die Erstellung erfolgt nach Bedarf, z.B. wenn eine neue Opennet Region hinzugefügt werden soll oder falls sich die Freifunk API geändert hat. Kontrolle ist über http://api-viewer.freifunk.net und den API Generator unter http://freifunk.net/api-generator/ möglich.
Freifunk Nodelist API
Die Nodelist API Dateien von Opennet werden über einen Konverter von Geronimo geronimo_freifunknodeslist.sh erzeugt. Ein Cronjon läuft alle 10 Minuten. Kontrolle ist über http://www.freifunk-karte.de/debug.php möglich. Probleme können auch über https://github.com/ffansbach/de-map/issues gemeldet werden.
TODO
- Auftrennung der Knotenliste in Opennet Regionen