Ausgangslage:

Der Amtlicher Gebietsschlüssel muss im Format 0916200000000 verwendet werden.

Probleme:

falsches Schüsselformat

Gemäß dem angegebene Beispiel JSON lautet der amtliche Gebietsschlüssel für z.B. Rednitzhembach 095760137137. Eine Anfrage mit dem Gebietsschlüssel liefert aber einen 404 Fehler.

Um für dieses Gebiet Informationen zu bekommen, muss bei der Anfrage der amtliche Gebietsschlüssel für den Landkreis Roth 095760000000 verwendet werden.

HTML im Fehlerfall

Die API sollte in einem Fehlerfall auch die Antwort als JSON senden. Werden bei der Anfrage nur statische JSON Dateien ausgeliefert?

Mögliche Lösung:

Die API ignoriert die letzten 7 Stellen im amtlichen Gebietsschlüssel.

In den Swagger "Try it out" Beispielen bekommt man die Fehlermeldung: TypeError: NetworkError when attempting to fetch resource., beispielsweise bei /dashboard/{AGS}.json.

Ich glaube, dass das daran liegt, dass die API nicht den Header access-control-allow-origin: * sendet. In der Browserkonsole werden die Daten im Netzwerktab angezeigt:

Bei der Autobahn-API funktioniert das "Try it out", da die API den Header korrekt sendet:

• /appdata/covid/covidinfos/DE/covidinfos.json
• /appdata/covid/covidticker/DE/covidticker.json
• /appdata/covid/covidticker/DE/tickermeldungen/{id}.json
• /appdata/covid/covidmap/DE/covidmap.json
• /appdata/gsb/logos/logos.json
• /appdata/gsb/logos/{filename}
• /appdata/gsb/eventCodes/eventCodes.json
• /appdata/gsb/eventCodes/{filename}
• /appdata/gsb/notfalltipps/DE/notfalltipps.json
• /appdata/gsb/faqs/DE/faq.json
• /dynamic/version/dataVersion.json
• /warnings/{identifier}.json
• /warnings/{identifier}.geojson
• /dwd/mapData.json
• /lhp/mapData.json
• /police/mapData.json

• Add a mention of the event code endpoint.

Fixes #12

Dieser PR deckt alle Endpunkte ab, die in #6 genannt wurden, AUSSER:

• => Spezifisch zur Android-App oder nicht-generischen Verwendungszwecken
  • /api31/appdata/gsb/onboarding/{prefix}/onboarding_v{version}_android.json
  • /api31/appdata/gsb/systemmeldungen/{prefix}/systemmeldungen_v1_android.json
  • /api31/appdata/gsb/html/{prefix}/app/datenschutz_matomo.html
  • /api31/appdata/gsb/html/{prefix}/app/impressum.html
• => HTTP 404
  • /api31/warnings/{id}.pl.json
  • /api31/appdata/gsb/labels/{prefix}_labels.json
• => Nicht unter /api31
  • https://warnung.bund.de/bbk.*

Hallo,

im Dokument https://github.com/bundesAPI/nina-api/blob/e7596c9ff375d15681c2ca201db0bc36dc7e7b67/openapi.yaml#L53 und an zwei weiteren darunter folgenden Stellen, hat sich ein kleiner Dreher eingeschlichen. Darauf wollte ich nur aufmerksam machen. ;)

• added contact

• added tags

• fixed warnings (operationId, description etc.)

• fixed errors ($ref must not be placed next to any other propertiesspectral(no-$ref-siblings))

• formatting

• update spectral version to latest

GET /warnings/{ID}.json

ID ist die "id" (z.B. mow.DE-BY-WEN-W130-20210908-001) aus den anderen json z.B. von https://warnung.bund.de/api31/mowas/mapData.json

liefert die Details der Meldung, z.B.

Request: https://warnung.bund.de/api31/warnings/mow.DE-BY-WEN-W130-20210908-001.json Reply:

  "identifier": "mow.DE-BY-WEN-W130-20210908-001",
  "sender": "DE-BY-WEN-W130",
  "sent": "2021-09-08T20:25:11+02:00",
  "status": "Actual",
  "msgType": "Alert",
  "scope": "Public",
  "code": [
    "DVN:9"
  ],
  "info": [
    {
      "language": "DE",
      "category": [
        "Health"
      ],
      "event": "Gefahrenmitteilung",
      "urgency": "Immediate",
      "severity": "Severe",
      "certainty": "Observed",
      "eventCode": [
        {
          "valueName": "profile:DE-BBK-EVENTCODE",
          "value": "BBK-EVC-069"
        }
      ],
      "headline": "Beeintr\u00e4chtigung der Trinkwasserqualit\u00e4t im Gemeindebereich Etzenricht",
      "description": "Beeintr\u00e4chtigung der Trinkwasserqualit\u00e4t im Gemeindebereich Etzenricht:<br/>Kochen Sie ihr Trinkwasser vor dem Gebrauch unbedingt ab.<br/>Zum Herstellen und Behandeln von Lebensmitteln ist nur abgekochtes Wasser zu verwenden.<br/>Gegenst\u00e4nde, die mit Lebensmitteln (auch Milch) direkt in Ber\u00fchrung kommen, sind mit abgekochtem Wasser zu reinigen.<br/>F\u00fcr S\u00e4uglinge, Kleinkinder und abwehrgeschw\u00e4chte Personen ist Wasser in abgepackter Form zu verwenden.",
      "instruction": "Informieren Sie sich in den Medien, zum Beispiel im Lokalradio.<br/>Kochen Sie das Wasser ab, bevor Sie es zum Trinken oder in der K\u00fcche verwenden.<br/>Wir informieren Sie, wenn die Gefahr vor\u00fcber ist.<br/>Kochen Sie ihr Trinkwasser vor dem Gebrauch unbedingt ab.<br/>Zum Herstellen und Behandeln von Lebensmitteln ist nur abgekochtes Wasser zu verwenden.<br/>Gegenst\u00e4nde, die mit Lebensmitteln (auch Milch) direkt in Ber\u00fchrung kommen, sind mit abgekochtem Wasser zu reinigen.<br/>F\u00fcr S\u00e4uglinge, Kleinkinder und abwehrgeschw\u00e4chte Personen ist Wasser in abgepackter Form zu verwenden.",
      "contact": "ILS Nordoberpfalz<br/>112",
      "parameter": [
        {
          "valueName": "instructionText",
          "value": "Kochen Sie ihr Trinkwasser vor dem Gebrauch unbedingt ab.\nZum Herstellen und Behandeln von Lebensmitteln ist nur abgekochtes Wasser zu verwenden.\nGegenst\u00e4nde, die mit Lebensmitteln (auch Milch) direkt in Ber\u00fchrung kommen, sind mit abgekochtem Wasser zu reinigen.\nF\u00fcr S\u00e4uglinge, Kleinkinder und abwehrgeschw\u00e4chte Personen ist Wasser in abgepackter Form zu verwenden."
        },
        {
          "valueName": "warnVerwaltungsbereiche",
          "value": "093745325119"
        },
        {
          "valueName": "instructionCode",
          "value": "BBK-ISC-009 BBK-ISC-066 BBK-ISC-014"
        },
        {
          "valueName": "sender_langname",
          "value": "Integrierte Leitstelle Nordoberpfalz"
        },
        {
          "valueName": "sender_signature",
          "value": "Integrierte Leitstelle Nordoberpfalz\nUlrich-Sch\u00f6nberger-Stra\u00dfe 11a \n92637 Weiden in der Oberpfalz"
        },
        {
          "valueName": "PHGEM",
          "value": "9448,100001"
        },
        {
          "valueName": "ZGEM",
          "value": "9448,100001"
        }
      ],
      "area": [
        {
          "areaDesc": "Gemeinde/Stadt: Gemeinde Etzenricht",
          "geocode": [
            {
              "valueName": "AreaId",
              "value": "0"
            }
          ]
        }
      ]
    }
  ]
  }```

To clearly identify them as string and not integer to avoid misinterpretation.

Currently value can be interpreted as int which leads to ags = "9.162E+10" in the generation process.

Ref.: https://stackoverflow.com/questions/19109912/yaml-do-i-need-quotes-for-strings-in-yaml

According to the OpenAPI specifications, the server addresses must not end on a slash (see https://swagger.io/specification/#server-object). Importing this in tools like Postman generates defective URLs containing two slashes. This PR fixes this.

Ich suche eine tiefergehende Dokumentation zur nina-api. Z.B. Vermisse ich eine BEschreibung welche werte manche Felder annehmen können, das betrifft vor allem Felder wie Severity, Urgency, Effective, Event, ... Sind dort ein Fester Wertebereich vorgegeben, oder ist das alles Freitext?

Bei der Abfrage https://nina.api.proxy.bund.dev/api31/dashboard/082150000000.json erhalte ich alle meldungten des Landkreises Karsruhe, ich möchte aber nur die Meldungen auswerten, die eine gezielte Gemeinde betreffen. Die Abfrage gab in meinem Fall folgendes Ergebnis: ` {

"id": "mow.DE-BW-KA-W138-20220827-001",
"payload": {
    "version": 2,
    "type": "ALERT",
    "id": "mow.DE-BW-KA-W138-20220827-001",
    "hash": "1f7ac6b8ae0e9e2a03754eeecc8cb08ab4c55e6c056a625bc50f4282bb4a4fa4",
    "data": {
        "headline": "Freisetzung einer Rauchwolke durch Brand",
        "provider": "MOWAS",
        "severity": "Minor",
        "msgType": "Update",
        "transKeys": {
            "event": "BBK-EVC-030"
        },
        "area": {
            "type": "ZGEM",
            "data": "10781+1,10794,100001"
        }
    }
},
"i18nTitle": {
    "de": "Freisetzung einer Rauchwolke durch Brand"
},
"sent": "2022-08-27T06:15:15+02:00"

}, `

Über die Detailabfrage ist erkennbar dass es sich um folgende Gemeinden handeln muss: Area Gemeinde/Stadt: Gemeinde Weingarten (Baden), Stadt Bruchsal, Stadt Stutensee Dieses Feld lässt sich aber nicht textuell auswerten, da, wenn die Anzahl der betroffenen Gemeinden zu groß wird, am Ende sinngemäß "und weitere 13 Gemeinden" steht. Somit kann ich aus diesem Feld nicht zuverlässig auswerten, ob meine Gemeinde betroffen ist.

In der Abfrage Dashboard von oben gibt es das Object Area, in dem wie ich annehme die SChlüssel von einzelnen Gemeinden komplett aufgelistet werden. Dabei sind einzelne Elemente mit +1 oder möglicherweise anderen Formeln angegeben. Wo finde ich die Beschreibung hierzu? Die Schlüssel die dort angegeben sind kann ich keinem AGS zuordnen, wie ist Hier der Zusammenhang zwischen Gemeinde und diesem Schlüssel?

Da die NINA App eine Filterung auf die Gemeinde zulässt, müssten die Daten der API das sicher auch zulassen.

Gibt es für die nina-api einen Pushservice, über den man ggf, für eine registrierte Region alle Warnmeldungen erhält. Polling scheint mir egal ob Server oder Client doch recht aufwendig.

Meine Vorstellung wäre ein WebSocket, MQTT oder andere Technik, die bei jeder Veränderung der Warnlage entweder die entsprechende ID erhält sofern man sich für einen speziellen AGS registriert hat. Alternativ für jede Veränderung eines Warnlevels wird der enstprechende AGS versandt, so dass man darauf nur bei Bedarf die Warnliste abrufen kann.

Hallo,

ich bräuchte für meinen Standort alle NINA-Warnungen. Ich habe es so verstanden, dass ich mir erst die Liste aller Warnungen holen muss, dann für jede einzelne Warnung das GeoJSON holen muss und dort prüfen, ob mein Standort darin liegt. Je nach Anzahl an Warnungen ist dies natürlich nicht gerade unaufwändig. Gibt es einen alternativen, einfacheren Weg?

All Warning url: https://warnung.bund.de/bbk.config/config_rel.json

AGS extended with 0 to 12 digits: https://warnung.bund.de/bbk.status/status_110000000000.json

Bucketname with ref Id https://warnung.bund.de/bbk.mowas/DE-NW-D-SE020-20210709-20-000.ohne.json

With geolocation https://warnung.bund.de/bbk.mowas/DE-NW-D-SE020-20210709-20-000.json

All endpoints should use with etag header if-none-match

Gibt es rate limits? Wenn ja wie hoch sind diese? Auch würde mich interessieren wer hinter den API Endpunkten und der Webseite https://bund.dev/ steht, da ein Impressum fehlt.