[WLANnews] Neue API Version! Updated eure Dateien

[Frank Rühlemann]

Das ist doch erkennbar gebaut, wenn man JSON einigermaßen verstanden hat.

Z.B sagt das hier klar, dass dieses Element „api“ vom Typ String sein
muss und ausschließlich die Werte "0.1", "0.2.0", "0.2.1", "0.3.0",
"0.3.1", "0.3.2," oder "0.4.0" enthalten darf, ohne Wert wird "0.4.0"
angenommen und es ist zwingend anzugeben:
> "api": {
> "title": "API",
> "type": "string",
> "description": "The Freifunk Community API version you use",
> "enum": ["0.1", "0.2.0", "0.2.1", "0.3.0", "0.3.1", "0.3.2,", "0.4.0"],
> "default": "0.4.0",
> "required": true
> },

Die Angaben sind als Meta-Informationen zu verstehen, die beschreiben,
was genau dort stehen darf und muss. Was du da hinschreibst, muss den
Anforderungen entsprechen. Und Nein, den Typ darfst du nicht einfach
ändern, denn sonst entspricht das nicht mehr der Vorgabe.

Ja, „number“ darf auch eine Fließkommazahl sein und da in JSON ein Komma
Elemente trennt, ist es – wie in 99% der Fälle der Informatik – ein
Punkt, der die Trennung vornimmt. Was am Ende raus kommt, muss gültiges
JSON sein, welches die Vorgaben einhält.

Schlüsselwörter darfst du gar nicht ändern, sondern die Stellen nach
gegebenen Kriterien ausfüllen.

Am 08.07.2014 14:48, schrieb Stephan (Freifunk Dresden):
> Hi,
>
> das habe ich auch schon gesehen, aber leider beschreibt es nicht, welche
> Felder welche werte annehmen können/dürfen/müssen, oder welche
> optional sind.
> Zum Beispiel weiss ich nicht ob ich die "Title" der einzelnen Objekte
> verändern darf oder
> muss. Oder ob "type" immer string sein muss oder es auch andere Werte
> gibt.
>
> Auch bei dem api-object ist nicht klar ob ich in dem enum alle
> versionen aufgeführt lassen muss, oder
> meine unterstützen versionen aufzählen soll (falls das überhaupt der
> sinn ist).
> Wozu gibt es dort den default Wert, wenn ein json nur eine bestimmte
> Version darstellen kann?
>
> Bei location wird als type "number" angegeben. Ich kann nur aus dem
> Beispiel vermuten, dass auch
> floating-point unterstützt ist und der Punkt als Komma verwendet wird.
>
> zum Beispiel wird in nodeMaps der type als Array angegeben. aber es
> ist dort kein array definiert mit "[ ]".
> Bei "state" wird type als Object definiert, was aber einen ähnlichen
> Aufbau hat, nur dass dort nicht "Items" sondern
> "properties" verwendet wird.
>
> Nachwelchem Schema sind zum Beispiel "pattern" aufgebaut und welchen
> zweck erfüllen diese pattern?
> Muss ich diese definieren? oder soll ich da eine URL selber einpflegen.
>
> Ich kann mir schon die Arbeit machen und den generator nutzen um dann
> herauszubekommen, was dieser dort generiert.
> Also welche felder er anders kodiert oder nicht verändert. Aber das
> ist leider nur eine Vermutung und keine
> spezifikation.
>
> Es ist für mich jedenfalls Unklar, welches Schlüsselwörter sind und
> nicht verändert werden darf oder wie die Wertebereiche
> und format der Daten definiert ist.
>
> Viele Grüße
> Stephan
>
> Am 08.07.2014 12:46, schrieb Frank Rühlemann:
>> Was du scheinbar suchst, befindet sich hier:
>> https://github.com/freifunk/api.freifunk.net/tree/master/specs
>

-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : 0x4682474F.asc
Dateityp    : application/pgp-keys
Dateigröße  : 3912 bytes
Beschreibung: nicht verfügbar
URL         : <http://lists.freifunk.net/pipermail/wlannews-freifunk.net/attachments/20140708/8bbede68/attachment.key>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : smime.p7s
Dateityp    : application/pkcs7-signature
Dateigröße  : 4909 bytes
Beschreibung: S/MIME Cryptographic Signature
URL         : <http://lists.freifunk.net/pipermail/wlannews-freifunk.net/attachments/20140708/8bbede68/attachment.bin>