[WLANnews] Passt eure API-Files an! Neue API-Spezifikation!

[Stephan (Freifunk Dresden)]

Hi,

ich (Freifunk Dresden) erstelle gerade mit dem Generator ein neues json 
file und
habe folgende Anmerkungen:

*Timeline
  Hier sollte es eine Auswahl geben mit vordefinierten Typen, wie zum 
Beispiel "Start" oder "Rekord".
  Sonst kann man keine Übersicht erstellen und die Werte der einzelnen 
Communities vergleichen.

*Node Map
  - hier ist nur die auswahl "olsr-dot" vorhanden, wobei das dot 
unabhängig vom protokoll ist.
  - interval: hier sollte ebenfalls ein festes format gegeben sein. 
Sekunden oder Minuten
  - map-technial-type ist ermöglicht nicht die angabe von google maps
    Es ist noch unklar wie ich zum Beispiel folgende karte einbinden 
kann:
     http://info.ddmesh.de/info/topo-freifunk.png
    ebenso die angabe einer url zu einem json file wäre von vorteil.
    Für iphone gibt es eine freifunk app, die bereits die knoten und 
links von verschieden städten
    bereitstellt. diese app wertet ein json file aus, welches die orte 
und verbindungen zwischen den
    knoten beinahltet. vielleicht sollte man diese informationen in das 
json file einbauen?
    https://github.com/phoet/freifunk_ios

*Technical
   Was ist mit "Firmware Name" gemeint? Unsere firmware hat keinen namen, 
maximal einen Filenamen
   der aber von openwrt buildroot erzeugt wird.

* Network
   Die dot-topology konnte doch schon bei "Node map" definiert werden 
?!?!?

Nach dem generieren, wurde bei "Homepage" gesagt, dass das pattern nicht 
stimmt.
Wie sieht dieses pattern aus? Habe eine URL ausprobiert, welche dann 
genommen wurde.
Das format sollte als Hinweis mit angegeben werden.

Der Button zum Generieren des files liegt beim Firefox hinter den 
Social-Buttons und lässt sich kaum drücken.

Auf der Generator Seite sollten Informationen über die Codierungen im 
json stehen. Also in welchem format
die Zeit zum Beispiel angegeben wird. Das ist hilfreich, wenn das json 
file automatisch generiert wird.

Viele Grüße
  Stephan (Freifunk Dresden)






Am 26.03.2014 17:47, schrieb Andreas Bräu:
> Hallo an alle,
> 
> in der letzten Zeit haben wir kräftig an den API-Spezifikationen
> geschraubt und viele Tickets abgearbeitet. Herausgekommen ist die
> API-Version 0.3.0.
> 
> Eine Liste aller Änderungen findet ihr unter
> http://blog.freifunk.net/2014/neues-aus-der-apiwerkstatt
> 
> Der API-Generator (und jetzt auch Validator) ist ebenfalls umgezogen 
> und
> ist unter http://freifunk.net/api-generator/ ‎zu finden.
> 
> Einige Felder sind nicht mehr rückwärtskompatibel zu älterem
> API-Versionen, da z.B. die Netzwerke jetzt in CIDR-Notation geführt, 
> die
> Zeitstempel im ISO-Format genutzt und andere Felder durch Pattern
> überprüft werden (Twitter-Accounts beginnen mit einem @). Bitte
> überprüft daher eure API-Files und passt sie gegebenenfalls an.
> 
> Nutzt bitte auch die Möglichkeiten, Informationen wie die Anzahl der
> Knoten oder Dienste automatisch und regelmäßig zu aktualisieren. Die
> Gluon-Entwickler haben ein Beispiel dafür unter
> http://luebeck.freifunk.net/wiki/Netzwerk:Skripte beschrieben und für
> OLSR-basierte Netzwerke gibt es eine Lösung bei Github:
> https://github.com/freifunk/common.api.freifunk.net/blob/master/contrib/ffapi-update-nodes.py
> 
> Monic vom Förderverein sagte mir, dass es im Moment sehr viel
> Presseaufmerksamkeit für Freifunk gibt und es daher sehr wünschenswert
> sei eine möglichst aktuelle und vollständige Übersicht über alle
> Freifunkcommunities zu bekommen. Die Journalisten fragen direkt nach
> solchen Informationen!
> 
> Falls ihr noch Nachbarcommunities kennt, die noch kein API-File haben,
> sagt Ihnen Bescheid, da wird die Erstellung auch kurz erklärt:
> http://blog.freifunk.net/2014/6-schritten-zum-apifile. Bei Fragen
> wendet euch bitte an mich.
> 
> Liebe Grüße
> 
> Andi
> 
> 
> _______________________________________________
> WLANnews mailing list
> WLANnews at freifunk.net
> Abonnement abbestellen? ->
> http://lists.freifunk.net/mailman/listinfo/wlannews-freifunk.net
> 
> Weitere Infos zu den freifunk.net Mailinglisten und zur An- und
> Abmeldung unter http://freifunk.net/mailinglisten

-- 
_____________________________________________
(Freifunk Dresden)