airQ-API nutzen



  • Hallo ihr Experten,
    könnt ihr mir kurz erklären, wie man Daten per API aus dem Air-Q abrufen kann? Gibt es dafür eine Anleitung?
    Ich habe mit derlei Datenabruf noch keine Erfahrung, würde das aber gern einmal ausprobieren...



  • Das Prinzip ist einfach, jedoch die Realisierung kann je nach Kenntnisstand schwierig sein.

    Über http://<IP-Adresse airQ>/data bekommst Du alle aktuellen Messwerte.
    Aber das ist mit AES256 verschlüsselt. Der Schlüssel ist das von Dir gewählte Passwort.

    Zum Entschlüsseln hängt es davon ab, welche Sprache Du verwenden willst.
    Für Javascript und Python findest Du unter https://air-q-updates.s3.eu-central-1.amazonaws.com/dokumentation/index.html entsprechende Beispiele.
    Und Du benötigst die dort angegebenen Bibliotheken.
    Mit php habe ich das auch schon gemacht.
    Andere Sprachen sollten prinzipiell auch kein Problem sein. Du brauchst "nur" die jeweiligen Bibliotheken zum Entschlüsseln.

    Entschlüsselt ist die Antwort dann ein JSON-String. In der oben angegebenen Beschreibung ist auch dieser ausreichend erklärt.

    Aus dem JSON-String holt man sich die gewünschten Daten und bringt diese zur Anzeige oder z.B. in eine eigene Datenbank.



  • @Micha
    Dankeschön, Micha!
    Ich würde die Daten gern in Excel importieren. Und da hänge ich momentan genau bei der Entschlüsselung fest... falls jemand Zeit & Lust für einen Tip in dieser Richtung hätte, würde ich mich freuen...



  • @Detlef
    In Excel d.h. mit VBA zu entschlüsseln, wird nicht so leicht gehen. MS bietet zwar in .net alles an, was man so braucht, aber VBA kann das nicht so einfach nutzen.
    Schau mal ob https://github.com/susam/aes.vbs Dir da weiterhilft, aber ich befürchte, das geht damit auch nicht gerade einfach, da für VBS. Ich habe das nicht ausprobiert und bin auch in VBA nicht so zu Hause.
    Alternative, wenn Du einen lokalen Server mit php hast. Decodiere mit einer php-Seite und lade in Excel von dieser Seite.



  • This post is deleted!


  • Diese Appliaktion habe ich noch einmal überarbeitet:
    Die Parameter werden im Dialog (optional abschaltbar) abgefragt:

    1c0b42ed-70ff-4d6b-89fb-6410271bab31-grafik.png

    Drückt man den Button "Start" dann werden die Daten angezeigt und alle x Sek, (Aktualisierungsrate) aktualisiert:
    f5d996f2-dbc2-4731-8729-eb1ec8800073-grafik.png

    Die Beschreibung habe ich etwas überarbeitet. Damit können auch weniger Technik versierte die Applikation nutzen.
    Ich schicke den Admins eine ZIP-Datei, damit diese hier herunter geladen werden kann.





  • Wer es hübscher möchte, kann die Daten auch via Grafana darstellen. Als Jump-Start hab ich mal mein JSON-File angehängt:
    9d71783d-dd2a-4190-aaf8-8c7c0dd14e59-image.png

    dazu müssen die Daten halt in eine Datenbank geladen werden, dazu gibt's aber viele Wege.
    Soll nur eine kleine Motivation bzw Denkanstoß sein, wer das API ausliest muss das "optische" nicht unbedingt selbst schreiben 🙂



  • @Openphil Sehr interessant, ich arbeite gerade an einem sehr ähnlichen Konzept auch mit Grafana.
    Aber dazu braucht man halt einen Web-Server, Datenbank, php und jede Menge technischer Kenntnisse. Das ist dann keine Plug&Play-Lösung mehr.
    Auf solch einer Basis möchte ich dann vor allem Korrelationen mit anderen Messwerten z.B. von den Landesanstalten für Umwelt und Wetterstationen aufzeichnen.



  • Wollte eben auch mal wieder etwas weiter an meiner Anwendung/meinem Framework für die AirQs arbeiten... als mir jetzt eben leider aufgefallen ist, dass die API-Dokus (wie Du sie oben auch bzw. die URL dorthin gepostet hast) leider nicht mehr verfügbar ist. 😞

    Beim Aufruf bekomme ich ein Access Denied. Ist sie nur umgezogen oder wirklich nicht mehr zugänglich?
    Das wäre natürlich extrem schade...



  • Hi @tuxbox,
    ja die URL für die technische Dokumentation hat sich vor einiger Zeit geändert.
    Über die URL https://docs.air-q.com/ kommst Du jetzt auf diese Doku. Du musst Dich dabei mit der Seriennummer Deines air-Q anmelden.



  • @Micha sagte in airQ-API nutzen:

    https://docs.air-q.com/

    Ganz herzlichen Dank schon mal für die Info. Leider gibts da für mich nur mehrere Probleme.
    Dort braucht man ja scheinbar die Seriennummer des AirQ. Zum einen stehen die bei mir nicht wie angegeben auf Lieferschein oder Rechnung (war damals ein Family-Package mit drei Stück.. das ist als Einzelposten eben ohne Seriennummer(n) aufgeführt).
    Die über die API übermittelte scheint wohl nicht gemeint zu sein oder akzeptiert zu werden... und/oder ich bin wohl plötzlich nicht mehr berechtigt für die API. 😞

    Laut der Seite geht das ja nur noch für Science, Select und Industry Modelle. Die von meinem Family-Package sind drei des Pro Modells.
    Hm, jemand einen Rat was ich noch probieren könnte?

    Noch scheinen meine eher noch provisorischen Skripte für meine eigene lokale Infrastruktur zwar noch zu gehen, aber wenn sich die API ja doch hin und wieder ändert (wie zB für die Kalibrierungen etc.) werd ich wohl über kurz oder lang in die Röhre sehen. Von weiteren Arbeiten daran das allgemein zugänglich/brauchbar zu machen ganz abgesehen.. 😞



  • @tuxbox
    Die Seriennummer findest Du auch im air-Q selbst. Unten wo der USB-Anschluss ist, sollte ein kleiner Aufkleber sein, auf dem u.a. auch die Seriennummer steht.



  • @Micha Danke nochmal.
    Das ist sogar in der Schreibweise der gleiche String/Seriennummer wie durch die API zurückgegeben wird. Hat auch genau zehn Stellen (weil in dem Formular steht die ersten zehn Zeichen.. mehr gibt es ja offenbar auch nicht).

    Leider habe ich dann wohl künftig keinen Zugang mehr. 😞
    Wars das jetzt dann wirklich mit Entwicklung an/für die AirQs?????



  • @tuxbox ...mh, ok, jetzt bin ich ganz verwirrt.. Heute komme ich jetzt plötzlich ganz ohne Seriennummer-Abfrage auf die API-Dokuseite docs.air-q.com drauf. 😳

    Wenn das so bleibt wärs' natürlich cool



  • @tuxbox
    hallo Frank. Das steht in unseren FAQ:

    Unterstützt der air-Q MQTT?
    Der air-Q unterstützt mit der "Science" Option MQTT. Bis Juli 2020 werden alle Geräte mit Science Option angeboten.
    (wir haben den Science erst danach angeboten und das vorher nicht getrennt).
    Du hast nun Zugriff auf die docs.air-q.com

    Wir würden uns freuen, wenn Du uns an Deinen Entwicklungen / Ergebnissen teilhaben lässt.
    Schönes Wochenende!

    Mario



  • @tuxbox das sollte nicht gehen. Geht es auch nicht - gerade probiert. Ich hatte in der Zwischenzeit Deine SN freigeschalten. Evtl war diese noch eingegeben?



  • @Mario-air-Q Dass die Seriennummer noch eingegeben/hinterlegt war kann natürlich sein. Habe jetzt in dem Sinne keinen Abmelde-Knopf auf der docs-Seite gefunden, sonst würde/könnte ich es nochmal ausprobieren. Im Augenblick zeigt er mir immer direkt die Doku gleich an.



  • @Mario-air-Q Nachdem ich mal wieder - zum Test, ob es mit Safari in der Web/Cloud-Oberfläche Fortschritte gibt - meine ganzen hinterlegten Daten für air-q.com gelöscht hatte kam jetzt auch wieder die Seriennummer-Abfrage. Und da funktionierte jetzt dann natürlich auch meine. Wunderbar, danke nochmal.


Log in to reply