Widget
APICall
Par CoCoTTe42 · v1.7.2
Note
4.6
Avis
114
téléchargements
1,000
Prix
Gratuit
Description
╭─── ≡ Description générale ╰─ APICall est un widget pour effectuer des requêtes HTTP, via le smartphone ou directement via WiFI ou LTE. L'usage principal est l'appel à des API REST d'équipements IOT ou de box domotique (Fibaro, eedomus, jeedom, zipa, vera ...) ou autres via ifttt.com, zapier... Si vous aimez, payez moi une bière ;o) → https://paypal.me/apicall → Bitcoin : bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garmin limite cette description à 4 000 caractères, la documentation complète et le guide d'utilisation est ici : https://apicall.dumesnil.net (en anglais) ╭─── ≡ Utilisation ╰─ Lorsque le widget est lancé, appuyer sur START ou MENU. Sélectionner la cible et l'action, puis appuyer sur le bouton START. "OK" ou "KO" avec le code d'erreur HTML est affiché. Appuyer sur MENU pour sélectionner un nouveau couple cible/action. Note : ‣ "START" : bouton START et/ou "tap" sur l'écran avec les montres tactiles ‣ "MENU" : pression longue sur le bouton UP, le bouton en bas à droite (Vivoactive 4), l'écran (montres tactiles) ... ╭─── ≡ Configuration ╰─ ⤇ La configuration s'effectue dans les options de l'application ConnectIQ. Chacune des 36 lignes permet de configurer une action sous la forme d'un JSON tel que : » Exemple simple : {deviceName:"Portail", actionName:"Ouvrir", url:"http://mon.url?pour=ouvrir"} » Exemple avec icônes et autonext : {deviceName:"Cinema", deviceIcon:7, autonext:true, actionName:"AllumerTV", actionIcon:11, url:"http://mon.url?allumer=tv"} • deviceName [obligatoire] : ‣ Type : string ‣ Description : Permet de regrouper plusieurs actions sous une même cible. • deviceIcon [optionnel] : ‣ Type : entier ‣ Default : 1 ‣ Description : Icône affichée à côté du nom de l'action (cf screenshot pour la liste). • autonext [optionnel] : ‣ Type : booléen [true|false] ‣ Default : false ‣ Description : Lors du lancement d'une action, l'action suivante de la cible est automatiquement sélectionnée. • actionName [obligatoire] : ‣ Type : string ‣ Description : Nom de l'action à effectuer. • actionIcon [optionnel] : ‣ Type : entier ‣ Default : 2 ‣ Description : Icône affichée à côté du nom de la cible (cf screenshot pour la liste). • url [obligatoire] : ‣ Type : string ‣ Description : URL de l'action à appeler. • autolaunch [optionnel] : ‣ Type : booléen [true|false] ‣ Default : false ‣ Description : L'action est lancée dès sa sélection. • method [optionnel] : ‣ Type : string ‣ Default : "GET" ‣ Description : ["GET"|"POST"|"PUT"], définit le type de requête HTTP. • POSTcontent [optionnel] : ‣ Type : string ‣ Default : "" ‣ Description : Est envoyé comme corqs de la requête quel soit la méthode (GET, POST, PUT), doit contenir un chaine de caractère de type JSON. Attention à bien échapper les " dans le contenu. Ex pour envoyer {"args":["3"]} : {POSTcontent:"{"args":["3"]}"} • resDisplay [optionnel] : ‣ Type : string ‣ Default : "" ‣ Description : Chemin JSON de la réponse à afficher. Si non défini, OK ou KO + code erreur est affiché en retour. Si "text", la réponse est affichée telle quelle (attention à la longueur de la réponse !) Ex : si le retour est {"myres":"xxx"}, pour afficher xxx il faut indiquer resDisplay:"myres". • media [optionnel] : ‣ Type : string ‣ Default : "" ‣ Description : ["BT"|"WIFI-LTE"], force le media à utiliser pour envoyer la requête. Par défaut : BT si connecté, sinon Wifi/LTE. • headers [optionnel] : ‣ Type : string ‣ Default : "{}" ‣ Description : Cette option permet de configurer les headers http. L'usage principale est destiné à configurer "Content-Type" et "Authorization". Garmin fait des vérifications sur le contenu des en-têtes, et malheureusement ceci n'est pas documenté. Il faut configurer un json sous la forme de paires de paramètres du type "nom de l'entête":"contenu". Voir le site web pour plus d'exemples.
Nouveautés
╭─── ≡ Note ╰─ La documentation complète et le guide d'utilisation est disponible ici : https://apicall.dumesnil.net (uniquement en anglais) ⊕⊕⊕ Attention ⊕⊕⊕ Plusieurs utilisateurs rapporte des problèmes avec l'utilisation de GarminExpress pour la configuration ou l'upgrade. Veuillez préférer l'utilisation de connectIQ. Pour les montres supportées qui ne disposent que de 60ko de mémoire, à savoir : ‣ fenix5, quatix5, fenix5s, fenixChronos ‣ forerunner245, forerunner645, forerunner935 ‣ venu ‣ vivoactive3 Note : les versions "music" ne sont pas concernées. Il est généralement possible de configurer environ 10 à 20 actions selon la complexité. Ensuite la mémoire est dépassée. Si un triangle bleu inversé apparait, tentez de limiter le nombre d'actions configurées. ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.2 : Ajout de la prise en charge des Egde 550, 850 & MTB, fenix8pro, venu4 & 1x ╭─────────────── 1.7.1 : Ajout de la prise en charge des Forerunner® 570 et 970 ╭─────────────── 1.7.0 : Changement de version du SDK 7.3 à 8.1. Correction d'un bug lors de l'utilisation de plus de 10 cibles ou de 10 actions sur une même cible. Ajout de la prise en charge des Descent™ G2, Mk1, Instinct® 3 Amoled (45 et 50mm), Vìvoactive® 6, Approach® S50. ╭─────────────── Les anciennes notes de version sont disponibles sur le site web.
Test
Article de test à venir.