Widget
APICall
Por CoCoTTe42 · v1.7.2
Valoración
4.6
Reseñas
114
descargas
1,000
Precio
Gratis
Descripción
╭─── ≡ Descripción general ╰─ APICall es un widget que permite llamar a URLs HTTP a través de Bluetooth desde teléfonos inteligentes, o directamente mediante Wi-Fi/LTE en dispositivos compatibles. Su uso habitual se dirige al acceso a API REST de dispositivos IoT, sistemas de automatización doméstica (Fibaro, eedomus, jeedom, zipa, vera, etc.) u otros servicios a través de herramientas como ifttt.com o Zapier. Si te gusta, ¡puedes invitarme a una cerveza! ;o) → https://paypal.me/apicall → Bitcoin: bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garmin limita esta descripción a 4.000 caracteres; la documentación completa se encuentra aquí: https://apicall.dumesnil.net ╭─── ≡ Uso ╰─ Al iniciar el widget, pulsa “INICIAR” o “ MENÚ”. Elige un dispositivo y una acción, luego pulsa “INICIAR” para ejecutarla. Se mostrará el resultado (“OK” o “KO”) junto con el código de error en formato HTML. Para seleccionar otro dispositivo/acción, pulsa “MENÚ”. **Notas:** ‣ “INICIAR” puede corresponder al botón correspondiente o a un toque en la pantalla en relojes táctiles. ‣ “MENÚ” se puede activar mediante un pulsado prolongado en el botón de arriba derecho, en el botón inferior derecho (en dispositivos Vivoactive 4) o en la pantalla (en relojes táctiles). ╭─── ≡ Configuración ╰─ La configuración se realiza a través del menú de ajustes de la aplicación Garmin ConnectIQ. Se deben definir 36 campos en formato cadena JSON, por ejemplo: » Ejemplo básico: `{deviceName:“Puerta”, actionName:“Abrir”, url:“http://mi.url?to=open”}` » Ejemplo con iconos y función de reenvío automático: `{deviceName:“Cine”, deviceIcon:7, autonext:true, actionName:“TV”, actionIcon:11, url:“http://mi.url?tv=on”}` **Parámetros:** • **deviceName** [Obligatorio]: Cadena de texto que identifica el dispositivo al que se aplica la acción. Permite agrupar acciones relacionadas con ese dispositivo. • **deviceIcon** [Opcional]: Entero que indica la icona a mostrar junto al nombre del dispositivo. Valor por defecto: 1. • **autonext** [Opcional]: Booleano que determina si la acción siguiente se ejecuta automáticamente tras completar la actual. Valor por defecto: false. • **actionName** [Obligatorio]: Cadena de texto que identifica la acción a realizar. • **actionIcon** [Opcional]: Entero que indica la icona a mostrar junto al nombre de la acción. Valor por defecto: 2. • **url** [Obligatorio]: Cadena de texto que contiene la dirección URL a la que se enviará la solicitud. • **autolaunch** [Opcional]: Booleano que indica si la acción se ejecuta inmediatamente tras su selección. Puede combinarse con “autonext”. • **method** [Opcional]: Cadena de texto que indica el tipo de solicitud HTTP (GET, POST, PUT). Valor por defecto: “GET”. • **POSTcontent** [Opcional]: Cadena de texto que contiene el cuerpo de la solicitud. Solo debe usarse con métodos GET, POST o PUT y debe ser un dato en formato JSON. Es necesario escapar los caracteres especiales si es necesario. Ejemplo: `{POSTcontent:“{"args":["3"]}"}`. • **resDisplay** [Opcional]: Cadena de texto que indica la ruta JSON para obtener el resultado a mostrar. Si no se especifica, solo se muestra “OK” o “KO” junto con el código de error. Si se establece como “text”, el resultado se muestra tal y como es. Ejemplo: si el resultado es `{"myres":"xxx"}`, se mostrará `resDisplay:"myres"`; si es `{"myres":["id":"xxx", "id":"yyy"]}`, se mostrará `resDisplay:"myres[0].id"`. • **media** [Opcional]: Cadena de texto que indica el medio a través del cual se enviará la solicitud (Bluetooth, Wi-Fi/LTE). Si no se especifica, se usará Bluetooth si está conectado, de lo contrario Wi-Fi/LTE. • **headers** [Opcional]: Cadena de texto que contiene los encabezados HTTP personalizados. Los más comunes son “Content-Type” y “Authorization”. Garmin realiza algunas verificaciones para evitar enviar datos no deseados; estas reglas no están documentadas oficialmente. Para usar esta opción, configura un objeto JSON con pares de “nombre_del_encabezado”:“contenido_del_encabezado”. Consulta el sitio web para más ejemplos.
Novedades
╭─── ≡ Nota ╰─ Puede encontrar la documentación completa y el manual aquí: https://apicall.dumesnil.net ⊕⊕⊕ ADVERTENCIA ⊕⊕⊕ Varios usuarios me han informado de problemas al configurar o actualizar sus dispositivos desde GarminExpress. Le recomendamos utilizar connectIQ en su lugar. Para los relojes compatibles que solo disponen de 60 KB de memoria, se incluyen: ‣ Fenix5, Quatix5, Fenix5s, FenixChronos ‣ Forerunner245, Forerunner645, Forerunner935 ‣ Venu ‣ Vivoactive3 Nota: Las versiones “Music” no se ven afectadas. Puede configurar entre 8 y 15 acciones en estos relojes, dependiendo de su complejidad; sin embargo, la memoria puede llenarse rápidamente. Si aparece un triángulo azul invertido, intente reducir el número de acciones configuradas. ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.2: Se añade soporte para los relojes Egde 550, 850 y MTB, Fenix8pro, Venu4 y 1x. ╭─────────────── 1.7.1: Se añade soporte para los Forerunner® 570 y 970. ╭─────────────── 1.7.0: Se cambia la versión principal del SDK, de 7.3 a 8.1. Se corrige un problema que aparecía al utilizar más de 10 dispositivos o 10 acciones en el mismo dispositivo. También se añade soporte para los Descent™ G2, Mk1, Instinct® 3 Amoled (45 y 50 mm), Vívoactive® 6 y Approach® S50. ╭─────────────── 1.6.0: Se cambia la versión principal del SDK, de 6.4 a 7.3. ╭─────────────── 1.5.2: Se añade soporte para los Fēnix® 7pro (sin conexión Wi-Fi), 7Xpro (sin conexión Wi-Fi), Forerunner® 165, 165m y Descent™ Mk3. 1.5.1: Se corrige un problema relacionado con la opción de configuración de “Content-type”; también se añade soporte para el Vivoactive5. 1.5.0: Se cambia la versión principal del SDK, de 4.2 a 6.4. Se añade soporte para los Venu® 3/3S. ╭─────────────── Las notas de lanzamiento de versiones anteriores están disponibles en el sitio web.
Reseña
Artículo de reseña próximamente.