Description

/!\ There is a bug issue opened, '\' are removed from parameters... Details here: https://forums.garmin.com/developer/connect-iq/i/bug-reports/backslashes-removed-in-parameters-1021277512 ╭─── ≡ General description ╰─ APICall is a widget for calling HTTP URLs throught Bluetooth via Smartphone or directly with WiFi/LTE for compatible devices. Typical usage is for calling REST API of IOT devices, home automation boxes - domotics (Fibaro, eedomus, jeedom, zipa, vera, ...) or others things via ifttt.com, zapier ... If you like it, give me a beer here ;o) → https://paypal.me/apicall → Bitcoin : bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garmin limits this description to 4 000 chars, the complete documentation is here : https://apicall.dumesnil.net ╭─── ≡ Usage ╰─ When you launch widget, press START or MENU. Select a device then an action, then press START button to launch. "OK" or "KO" with the HTML error code is displayed. Press MENU to select a new device/action. Note : ‣ "START" can be START button and/or a "tap" on screen for touch watches. ‣ "MENU" can be a long press on UP button, on bottom right button (Vivoactive 4), on the screen (touch watches)… ╭─── ≡ Configuration ╰─ ⤇ The configuration is done in settings menu in Garmin ConnectIQ application. There is 36 lines that have to be set as a JSON string like : » Example (basic) : {deviceName:"Gate", actionName:"Open", url:"http://my.url?to=open"} » Example (with icons and autonext) : {deviceName:"Cinema", deviceIcon:7, autonext:true, actionName:"TV", actionIcon:11, url:"http://my.url?tv=on"} • deviceName [mandatory] : ‣ Type : string ‣ Description : Set the name of the device to which the action belongs. It permit to group some actions under a same device. • deviceIcon [optionnal] : ‣ Type : integer ‣ Default : 1 ‣ Description : Icon to be displayed next to the name of the device. • autonext [optionnal] : ‣ Type : boolean [true|false] ‣ Default : false ‣ Description : When launching an action, the next action of the device is automatically selected. • actionName [mandatory] : ‣ Type : string ‣ Description : Name of the action • actionIcon [optionnal] : ‣ Type : integer ‣ Default : 2 ‣ Description : Icon to be displayed next to the name of the action. • url [mandatory] : ‣ Type : string ‣ Description : URL to be launched • autolaunch [optionnal] : ‣ Type : boolean [true|false] ‣ Default : false ‣ Description : Applies to the action. The action is launched immediatly after selection. Can work with autonext. • method [optionnal] : ‣ Type : string ‣ Default : "GET" ‣ Description : ["GET"|"POST"|"PUT"], set the HTTP request type. • POSTcontent [optionnal] : ‣ Type : string ‣ Default : "" ‣ Description : Send as request content with all method (GET, POST and PUT). It must contain a JSON type string. Be carreful to escape the " in the content if necessary. Exemple to send {"args":["3"]} : {POSTcontent:"{"args":["3"]}"}. • resDisplay [optionnal] : ‣ Type : string ‣ Default : "" ‣ Description : Put a JSON path to fetch the element to display. If not defined, only the message OK or KO + error code is displayed as return. If "text", the response is displayed as it is (pay attention to the length of the response…) Ex : if result is {"myres":"xxx"}, xxx is displayed with resDisplay:"myres". Ex : if result is {"myres":["id":"xxx", "id":"yyy"]}, xxx is displayed with resDisplay:"myres[0].id". • media [optionnal] : ‣ Type : string ‣ Default : "" ‣ Description : ["BT"|"WIFI-LTE"], force to launch the request through a specific media. If not set, default behavior is BT if connected, else Wifi/LTE. • headers [optionnal] : ‣ Type : string ‣ Default : "{}" ‣ Description : This option permit to set custom http headers. The main usage is to set the "Content-Type" and "Authorization" headers. Garmin do some checks that prevent to send everything you want, and these checks are unfortunately not documentated... To use the option, you need to configure

What is new

╭─── ≡ Note ╰─ You can find the complete documentation and manual here : https://apicall.dumesnil.net ⊕⊕⊕ WARNING ⊕⊕⊕ Several users report me some issues when configuring or upgrading from garminExpress. Please prefer use connectIQ. For supported watches which only have 60kb of memory, namely : ‣ fenix5, quatix5, fenix5s, fenixChronos ‣ forerunner245, forerunner645, forerunner935 ‣ venu ‣ vivoactive3 Note: "music" versions are not affected. You can configure about 8 to 15 actions on these watches depending on their complexity, then memory is full. If a reverse bleu triangle appears, try to limit the number of configured actions. ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.3 : Add support of fēnix9, Forerunner® 70/170, Approach® S72, D2™ Mach 2, Enduro™ 4 ╭─────────────── 1.7.2 : Add support of Egde 550, 850 & MTB, fēnix®8pro, Venu®4 & 1x ╭─────────────── 1.7.1 : Add support of Forerunner® 570 and 970 ╭─────────────── 1.7.0 : Change SDK major release. From 7.3 to 8.1 Bug fix when using more than 10 devices or 10 actions on a same device. Add support of Descent™ G2, Mk1, Instinct® 3 Amoled (45 and 50mm), Vìvoactive® 6, Approach® S50 ╭─────────────── 1.6.0 : Change SDK major release from 6.4 to 7.3. ╭─────────────── 1.5.2 : Add support of Fēnix® 7pro-nonwifi) , 7Xpro-nonwifi, Forerunner® 165, 165m, Descent™ Mk3 1.5.1 : Fix an issue with the headers option, "Content-type" was not correctly handled. Add vivoactive5. 1.5.0 : Change SDK major release from 4.2 to 6.4. Add Venu® 3/3S support. ╭─────────────── Older version release notes are avalaible on the web site.

Screenshots

APICall · Screenshot 0 APICall · Screenshot 1 APICall · Screenshot 2 APICall · Screenshot 3 APICall · Screenshot 4

Supported languages (2)

English Français

Compatible devices (224)

Approach® S50 Approach® S70 (42mm) Approach® S70 (47mm) Approach® S72 - 43 mm Approach® S72 - 47 mm Captain Marvel Captain Marvel D2™ Air D2™ Air X10 D2™ Air X15 D2™ Delta D2™ Delta PX D2™ Delta S D2™ Mach 1 D2™ Mach 1 Pro D2™ Mach 2 D2™ Mach 2 Pro Darth Vader™ Darth Vader™ Descent™ G2 Descent™ Mk1 Descent™ Mk1 Descent™ MK2 Descent™ MK2 Descent™ Mk2S Descent™ Mk2S Descent™ MK3 - 43mm Descent™ MK3i - 51mm Edge® 1030 Edge® 1030 Edge® 1030 Plus Edge® 1030 Plus Edge® 1030, Bontrager Edge® 1040 Edge® 1040 Edge® 1050 Edge® 520 Plus Edge® 520 Plus Edge® 530 Edge® 530 Edge® 540 Edge® 550 Edge® 830 Edge® 830 Edge® 840 Edge® 850 Edge® Explore Edge® Explore 2 Edge® MTB Enduro™ Enduro™ Enduro™ 2 Enduro™ 3 Enduro™ 4 epix™ (Gen 2) epix™ (Gen 2) epix™ Pro (42mm) epix™ Pro (47mm) epix™ Pro (51mm) fēnix® 5 fēnix® 5 fēnix® 5 Plus fēnix® 5 Plus fēnix® 5S fēnix® 5S fēnix® 5S Plus fēnix® 5S Plus fēnix® 5X fēnix® 5X fēnix® 5X Plus fēnix® 5X Plus fēnix® 6 fēnix® 6 fēnix® 6 Dual Power fēnix® 6 Pro fēnix® 6 Pro fēnix® 6 Pro Dual Power fēnix® 6 Pro Solar fēnix® 6 Solar fēnix® 6S fēnix® 6S fēnix® 6S Dual Power fēnix® 6S Pro fēnix® 6S Pro fēnix® 6S Pro Dual Power fēnix® 6S Pro Solar fēnix® 6S Solar fēnix® 6X Pro fēnix® 6X Pro fēnix® 7 fēnix® 7 fēnix® 7 Pro fēnix® 7 Pro – Solar Edition (No Wi-Fi®) fēnix® 7S fēnix® 7S fēnix® 7S Pro fēnix® 7X fēnix® 7X fēnix® 7X Pro fēnix® 7X Pro No Wi-Fi fēnix® 8 AMOLED (43mm) fēnix® 8 AMOLED (47mm/51mm) fēnix® 8 Pro fēnix® 8 Solar (47mm) fēnix® 8 Solar (51mm) fenix® 9 - 43 mm fenix® 9 – 47 mm fenix® 9 Pro - 43 mm fenix® 9 Pro - 47 mm fenix® 9 Pro - 51 mm fenix® 9 Pro - Solar 47 mm fenix® 9 Pro - Solar 51 mm fēnix® Chronos fēnix® Chronos fēnix® E First Avenger First Avenger ForeAthlete 245 ForeAthlete 245 Music ForeAthlete 55 ForeAthlete 645 ForeAthlete 645 Music ForeAthlete 745 ForeAthlete 935 Forerunner® 165 Forerunner® 165 Music Forerunner® 170 Forerunner® 170 Music Forerunner® 245 Forerunner® 245 Forerunner® 245 Music Forerunner® 245 Music Forerunner® 255 Forerunner® 255 Music Forerunner® 255S Forerunner® 255S Music Forerunner® 265 Forerunner® 265S Forerunner® 55 Forerunner® 55 Forerunner® 570 - 42mm Forerunner® 570 - 47mm Forerunner® 645 Forerunner® 645 Music Forerunner® 70 Forerunner® 70 Forerunner® 745 Forerunner® 935 Forerunner® 945 Forerunner® 945 Forerunner® 945 LTE Forerunner® 955 Dual Power Forerunner® 965 Forerunner® 970 Instinct® 3 – 45 mm, AMOLED Instinct® 3 – 50 mm, AMOLED Instinct® Crossover AMOLED MARQ® (Gen 2) MARQ® Commander (Gen 2) – Carbon Edition MARQ™ Adventurer MARQ™ Adventurer MARQ™ Athlete MARQ™ Athlete MARQ™ Aviator MARQ™ Aviator MARQ™ Aviator (Gen 2) MARQ™ Captain MARQ™ Captain MARQ™ Commander MARQ™ Commander MARQ™ Driver MARQ™ Driver MARQ™ Expedition MARQ™ Expedition MARQ™ Golfer MARQ™ Golfer Mercedes-Benz Venu® Mercedes-Benz Venu® Mercedes-Benz Venu® 2 Mercedes-Benz Venu® 2 Mercedes-Benz Venu® 2S Mercedes-Benz Venu® 2S quatix® 6 quatix® 6X Rey™ Rey™ tactix® 7 tactix® 7 – AMOLED Edition tactix® 8 – 47 mm, AMOLED tactix® 8 – 51 mm, Solar Venu® Venu® Venu® 2 Venu® 2 Venu® 2 Plus Venu® 2 Plus Venu® 2S Venu® 2S Venu® 3 Venu® 3S Venu® 4 – 41 mm Venu® 4 – 45 mm Venu® Sq. Venu® Sq. Venu® Sq. Venu® Sq. Venu® Sq. 2 Venu® Sq. 2 Music Venu® Sq. Music Venu® Sq. Music Venu® Sq. Music Venu® Sq. Music Venu® X1 vívoactive® 3 vívoactive® 3 vívoactive® 3 Music vívoactive® 3 Music vívoactive® 3 Music vívoactive® 4 vívoactive® 4 vívoactive® 4S vívoactive® 4S vívoactive® 5 vívoactive® 6