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

[Andreas Bräu]

> *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.

hm, hier kam es vor allem auf ein Datum und eine Beschreibung des Events
an. Ansonsten müssten wir wieder zig Sachen vorgeben...

> 
> *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

dieses Thema ist auch noch nicht fertig diskutiert und implementiert.
Ich ringe hier noch damit, entsprechende Typen vorzugeben, die
Vorschläge im Github waren mir bisher zu speziell.

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

Viele Communities haben einen Nickname für ihre Firmware, um z.B. eine
Version zu identifizieren.

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

ist in der Tat doppelt, das werde ich demnächst entfernen

> 
> 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.

bei den meisten steht ein Hinweis zum Format da, habe das jetzt
entsprechend für die fehlenden Felder, die Pattern nutzen ergänzt

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

gestern gings noch :-( blödes iframe-zeug

> 
> 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.

wie und wo meinst du genau?

Grüße

Andi

> 
> 
> 
> 
> 
> 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
> 


-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : smime.p7s
Dateityp    : application/x-pkcs7-signature
Dateigröße  : 5494 bytes
Beschreibung: nicht verfügbar
URL         : <http://lists.freifunk.net/pipermail/wlannews-freifunk.net/attachments/20140326/2b33f7d3/attachment.bin>