Opennet API: Unterschied zwischen den Versionen
Aus Opennet
Lars (Diskussion | Beiträge) K (korrigiere git-URL) |
Lars (Diskussion | Beiträge) (Hinweis auf http-Abruf von ondataservice-Daten) |
||
Zeile 25: | Zeile 25: | ||
* Wiki: AP-Liste mit Besitzern und Positionen | * Wiki: AP-Liste mit Besitzern und Positionen | ||
* [[Ondataservice]]: Hardware, Firmware, Systemzustand, Netzwerkschnittstellen | * [[Ondataservice]]: Hardware, Firmware, Systemzustand, Netzwerkschnittstellen | ||
+ | ** derselbe Datensatz ist auch via [[Ondataservice#Alternativer_HTTP-Abruf|HTTP-Abruf]] verfügbar (erfordert eine manuelle Anpassung für Firmware bis 0.5.4) | ||
* [[OLSR]]: Links, Qualität, "lastseen"-Zeitstempel | * [[OLSR]]: Links, Qualität, "lastseen"-Zeitstempel | ||
* manuell gepflegte Liste von Regionen für [[Freifunk API]] | * manuell gepflegte Liste von Regionen für [[Freifunk API]] |
Aktuelle Version vom 13. April 2019, 13:15 Uhr
Die Opennet API (Geronimo v2) bietet Statusdaten des Mesh-Netzwerks und Meta-Daten der lokalen Communities basierend auf verschiedenen Quellen mittels einer REST-API an. Der Vorgänger dieses Diensts war Geronimo v1.
Inhaltsverzeichnis |
[Bearbeiten] Überblick
- Vorgedanken und Funktionsumfang: Geronimo/v2/Planung
- Tickets
URLs für einen Node:
- https://api.opennet-initiative.de/api/v1/accesspoint/192.168.1.11
- https://api.opennet-initiative.de/api/v1/accesspoint/192.168.1.11/links
Für alle Nodes:
- https://api.opennet-initiative.de/api/v1/accesspoint/
- https://api.opennet-initiative.de/api/v1/link
- https://api.opennet-initiative.de/api/v1/interface
Filtern nach AP-Status, z.B. "online" (alternativ "flapping")
Für JSON-Format ?format=json anhängen, z.B.:
Für GeoJSON ?format=geojson, z.B. alle Links im GeoJSON Format:
[Bearbeiten] Datenquellen
- Wiki: AP-Liste mit Besitzern und Positionen
- Ondataservice: Hardware, Firmware, Systemzustand, Netzwerkschnittstellen
- derselbe Datensatz ist auch via HTTP-Abruf verfügbar (erfordert eine manuelle Anpassung für Firmware bis 0.5.4)
- OLSR: Links, Qualität, "lastseen"-Zeitstempel
- manuell gepflegte Liste von Regionen für Freifunk API
[Bearbeiten] Funktionsumfang
- Zusammenfassung verschiedener Datenquelle
- aktuelle Zustände von Accesspoints und Links ausliefern
- Metadaten für die Freifunk API ausliefern
[Bearbeiten] Architektur
- Django-Anwendung liefert Daten via REST-Framework aus (inkl. Unterstützung für Geodaten - z.B. Bounding-Box-Limitierung von Abfragen)
- Import von Daten aus den verschiedenen Quellen via cron-Jobs
[Bearbeiten] Entwicklung
- git-Repository auschecken: git clone https://dev.opennet-initiative.de/git/on_geronimo
- Dienst lokal starten: python3 manage.py runserver
- Daten importieren (manuell):
- python3 manage.py import_wiki
- python3 manage.py import_olsr http://192.168.2.76:2006/
- python3 manage.py import_ondataservice examples/ondataservice.db
- API abfragen (z.B. Browser oder curl): http://localhost:8000/api/v1/accesspoint/
- Release erstellen: make release-(major|minor|patch)
- deb-Paket bauen: make dist-deb
- deb-Paket bauen und auf einem Server installieren: make deploy-deb-remote DEPLOY_TARGET=root@example.on
[Bearbeiten] Installation
- deb-Paket installieren (zuvor eventuell manuell erstellen - siehe oben)
- den Anweisungen aus der Datei /usr/share/doc/on-geronimo-api/README.Debian folgen