Widget
APICall
Von CoCoTTe42 · v1.7.2
Bewertung
4.6
Bewertungen
114
Downloads
1,000
Preis
Kostenlos
Beschreibung
╭─── ≡ Allgemeine Beschreibung ╰─ APICall ist ein Widget, mit dem HTTP-URLs über Bluetooth über das Smartphone oder direkt über WLAN/LTE bei kompatiblen Geräten aufgerufen werden können. Typische Anwendungen sind der Aufruf von REST-APIs von IoT-Geräten, Heimautomatisierungssystemen wie Fibaro, eedomus, jeedom usw. sowie über Plattformen wie ifttt.com oder Zapier. Falls Ihnen das Widget gefällt, spenden Sie mir doch ein Bier ;o) → https://paypal.me/apicall → Bitcoin: bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garmin begrenzt die Länge dieser Beschreibung auf 4.000 Zeichen; die vollständige Dokumentation finden Sie hier: https://apicall.dumesnil.net ╭─── ≡ Verwendung ╰─ Starten Sie das Widget und drücken Sie anschließend „START“ oder „MENU“. Wählen Sie zunächst ein Gerät aus, dann die gewünschte Aktion – danach drücken Sie erneut „START“, um die Aktion auszuführen. Es wird entweder „OK“ angezeigt oder der entsprechende HTML-Fehlercode. Um ein anderes Gerät bzw. eine andere Aktion auszuwählen, verwenden Sie „MENU“. Hinweise: ‣ „START“ kann entweder durch Drücken der entsprechenden Taste oder durch Berühren des Bildschirms bei Touch-Uhren erfolgen. ‣ „MENU“ lässt sich bei manchen Geräten durch längeres Drücken der oben rechten Taste oder direkt auf dem Bildschirm aktivieren. ╭─── ≡ Konfiguration ╰─ Die Konfiguration erfolgt im Menü „Einstellungen“ der Garmin ConnectIQ-App. Es müssen insgesamt 36 Einstellungen als JSON-String angegeben werden, zum Beispiel so: » Beispiel (basisch): {deviceName: „Gate“, actionName: „Open“, url: „http://my.url?to=open“} » Beispiel (mit Symbolen und automatischer Weiterführung): {deviceName: „Cinema“, deviceIcon: 7, autonext: true, actionName: „TV“, actionIcon: 11, url: „http://my.url?tv=on“} • **deviceName** [pflichtig]: ‣ Typ: String ‣ Beschreibung: Name des Geräts, für das die Aktion ausgeführt werden soll. Dies ermöglicht es, mehrere Aktionen unter einem Gerät zusammenzufassen. • **deviceIcon** [optional]: ‣ Typ: Integer ‣ Standardwert: 1 ‣ Beschreibung: Symbol, das neben dem Gerätenamen angezeigt wird. • **autonext** [optional]: ‣ Typ: Boolean (true|false) ‣ Standardwert: false ‣ Beschreibung: Bei Ausführung einer Aktion wird automatisch die nächste verfügbare Aktion des Geräts ausgewählt. • **actionName** [pflichtig]: ‣ Typ: String ‣ Beschreibung: Name der auszuführenden Aktion. • **actionIcon** [optional]: ‣ Typ: Integer ‣ Standardwert: 2 ‣ Beschreibung: Symbol, das neben dem Aktionsnamen angezeigt wird. • **url** [pflichtig]: ‣ Typ: String ‣ Beschreibung: URL, an die die Anfrage gesendet werden soll. • **autolaunch** [optional]: ‣ Typ: Boolean (true|false) ‣ Standardwert: false ‣ Beschreibung: Die Aktion wird sofort nach der Auswahl ausgeführt. Kann zusammen mit „autonext“ verwendet werden. • **method** [optional]: ‣ Typ: String ‣ Standardwert: „GET“ ‣ Beschreibung: Art der HTTP-Anfrage („GET“, „POST“, „PUT“). • **POSTcontent** [optional]: ‣ Typ: String ‣ Standardwert: „“ ‣ Beschreibung: Inhalt der Anfrage, insbesondere bei Methoden wie „POST“ oder „PUT“. Muss ein JSON-String sein. Bei Bedarf müssen eventuell spezielle Zeichen im Inhalt entfernt werden. Beispiel: `{POSTcontent: "{"args": ["3"]}"`. • **resDisplay** [optional]: ‣ Typ: String ‣ Standardwert: „“ ‣ Beschreibung: JSON-Pfad, über den das zurückgegebene Ergebnis abgerufen werden soll. Wenn dieser nicht definiert ist, wird nur die Meldung „OK“ oder „KO“ zusammen mit dem Fehlercode angezeigt. Bei Angabe des Wertes „text“ wird die Antwort in ihrer ursprünglichen Form angezeigt. Beispiel: Wenn das Ergebnis „{myres: „xxx“}“ lautet, wird „xxx“ unter „resDisplay: „myres““ angezeigt. • **media** [optional]: ‣ Typ: String ‣ Standardwert: „“ ‣ Beschreibung: Medium, über das die Anfrage durchgeführt werden soll („BT“, „WIFI-LTE“). Falls nicht festgelegt, wird standardmäßig Bluetooth verwendet, sofern eine Verbindung besteht; andernfalls WLAN/LTE. • **headers** [optional]: ‣ Typ: String ‣ Standardwert: „{}“ ‣ Beschreibung: Es ist möglich, benutzerdefinierte HTTP-Header zu definieren. Am häufigsten werden dabei die Header „Content-Type“ und „Authorization“ verwendet. Garmin führt jedoch Überprüfungen durch, die es verhindern, dass beliebige Daten gesendet werden können – diese Überprüfungen sind leider nicht dokumentiert. Um diese Option zu nutzen, müssen Sie einen JSON-String mit Paaren der Form „„Name des Headers“: „Inhalt des Headers““ konfigurieren. Weitere Beispiele finden Sie auf der Website.
Neuigkeiten
╭─── ≡ Hinweis ╰─ Die vollständige Dokumentation und Anleitung finden Sie hier: https://apicall.dumesnil.net ⊕⊕⊕WARNUNG ⊕⊕⊕ Mehrere Nutzer haben mir Probleme beim Konfigurieren oder Upgraden von Geräten mit GarminExpress gemeldet. Bitte verwenden Sie lieber die ConnectIQ-Plattform. Für unterstützte Uhren, die nur über 60 KB Speicher verfügen – insbesondere: ‣ Fenix5, Quatix5, Fenix5s, FenixChronos ‣ Forerunner245, Forerunner645, Forerunner935 ‣ Venu ‣ Vivoactive3 Hinweis: Die „Music“-Versionen sind nicht betroffen. Auf diesen Uhren können je nach Komplexität etwa 8 bis 15 Aktionen konfiguriert werden – danach ist der Speicher voll. Wenn ein blaues Dreieck angezeigt wird, versuchen Sie bitte, die Anzahl der konfigurierten Aktionen zu reduzieren. ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.2: Hinzufügung der Unterstützung für Egde 550, 850 & MTB, Fenix8pro, Venu4 sowie 1x. ╭─────────────── 1.7.1: Hinzufügung der Unterstützung für Forerunner® 570 und 970. ╭─────────────── 1.7.0: Änderung der major Version des SDKs von 7.3 auf 8.1. Behebung eines Fehlers bei der Verwendung von mehr als 10 Geräten oder 10 Aktionen auf einem Gerät. Hinzufügung der Unterstützung für Descent™ G2, Mk1, Instinct® 3 Amoled (45 und 50 mm), Vivoactive® 6 sowie Approach® S50. ╭─────────────── 1.6.0: Änderung der major Version des SDKs von 6.4 auf 7.3. ╭─────────────── 1.5.2: Hinzufügung der Unterstützung für Fēnix® 7pro (ohne WLAN), 7Xpro (ohne WLAN), Forerunner® 165, 165m sowie Descent™ Mk3. 1.5.1: Behebung eines Problems mit der Option „Header“ – die Angabe „Content-type“ wurde nicht korrekt verarbeitet. Hinzufügung der Unterstützung für Vivoactive5. 1.5.0: Änderung der major Version des SDKs von 4.2 auf 6.4. Hinzufügung der Unterstützung für Venu® 3/3S. ╭─────────────── Erläuterungen zu früheren Versionen finden Sie auf der Website.
Bewertung
Bewertungsartikel kommt bald.