Widget
APICall
Por CoCoTTe42 · v1.7.2
Avaliação
4.6
Avaliações
114
downloads
1,000
Preço
Grátis
Descrição
╭─── ≡ Descrição geral ╰─ O APICall é um widget usado para enviar solicitações HTTP via Bluetooth através de smartphones ou, diretamente, por Wi-Fi/LTE em dispositivos compatíveis. O uso típico é para acessar APIs REST de dispositivos IoT, sistemas de automação residencial (Fibaro, eedomus, jeedom, zipa, vera, etc.) ou outros recursos disponíveis através de serviços como ifttt.com ou zapier. Se gostou, dê-me uma cerveja ;) → https://paypal.me/apicall → Bitcoin: bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 A Garmin limita esta descrição a 4.000 caracteres; a documentação completa está disponível aqui: https://apicall.dumesnil.net ╭─── ≡ Uso ╰─ Ao iniciar o widget, pressione “INICIAR” ou “MENU”. Escolha um dispositivo e uma ação, depois clique em “INICIAR” para executá-la. Serão exibidos os resultados (“OK” ou “KO”), juntamente com o código de erro HTML, se houver algum. Para selecionar outro dispositivo/ação, pressione “MENU”. **Observações:** ‣ “INICIAR” pode ser representado pelo botão correspondente ou por um toque na tela em relógios touch. ‣ “MENU” pode ser alcançado através de um toque prolongado no botão “PARA CIMA”, no botão inferior direito (no Vivoactive 4) ou diretamente na tela em relógios touch. ╭─── ≡ Configuração ╰─ A configuração é feita no menu de “Configurações” do aplicativo Garmin ConnectIQ. São necessárias 36 linhas, formatadas como um string JSON, por exemplo: » Exemplo básico: `{deviceName:“Portão”, actionName:“Abrir”, url:“http://my.url?to=open”}` » Exemplo com ícones e funcionalidade de continuação automática: `{deviceName:“Cinema”, deviceIcon:7, autonext:true, actionName:“TV”, actionIcon:11, url:“http://my.url?tv=on”}` **Parâmetros:** • **deviceName** [obrigatório]: ‣ Tipo: string ‣ Descrição: Nome do dispositivo ao qual a ação se refere. Permite agrupar várias ações sob o mesmo dispositivo. • **deviceIcon** [opcional]: ‣ Tipo: integer ‣ Valor padrão: 1 ‣ Descrição: Ícone que será exibido ao lado do nome do dispositivo. • **autonext** [opcional]: ‣ Tipo: booleano ([true|false]) ‣ Valor padrão: false ‣ Descrição: Ao executar uma ação, a próxima ação automática do dispositivo é selecionada automaticamente. • **actionName** [obrigatório]: ‣ Tipo: string ‣ Descrição: Nome da ação a ser executada. • **actionIcon** [opcional]: ‣ Tipo: integer ‣ Valor padrão: 2 ‣ Descrição: Ícone que será exibido ao lado do nome da ação. • **url** [obrigatório]: ‣ Tipo: string ‣ Descrição: URL para onde a solicitação HTTP deve ser enviada. • **autolaunch** [opcional]: ‣ Tipo: booleano ([true|false]) ‣ Valor padrão: false ‣ Descrição: A ação é executada imediatamente após a seleção. Pode funcionar em conjunto com a opção “autonext”. • **method** [opcional]: ‣ Tipo: string ‣ Valor padrão: “GET” ‣ Descrição: Tipo da solicitação HTTP (“GET”, “POST” ou “PUT”). • **POSTcontent** [opcional]: ‣ Tipo: string ‣ Descrição: Conteúdo a ser enviado com a solicitação. Deve estar em formato JSON. Se necessário, escape os caracteres “” no conteúdo. Exemplo: `{POSTcontent:“{"args":["3"]}”}`. • **resDisplay** [opcional]: ‣ Tipo: string ‣ Descrição: Caminho JSON para obter o elemento a ser exibido como resposta. Se não especificado, apenas a mensagem “OK” ou “KO”, juntamente com o código de erro, será mostrada. Se for definido como “text”, a resposta será exibida na forma original (atenção ao tamanho da resposta…). Exemplo: se a resposta for `{"myres":"xxx"}`, “xxx” será exibido como `resDisplay:“myres”`. • **media** [opcional]: ‣ Tipo: string ‣ Descrição: (“BT” ou “WIFI-LTE”): Força o uso de uma determinada tecnologia para enviar a solicitação. Se não especificado, o comportamento padrão será BT se conectado à rede Bluetooth, e Wi-Fi/LTE caso contrário. • **headers** [opcional]: ‣ Tipo: string ‣ Descrição: Permite definir cabeçalhos HTTP personalizados. Os principais são “Content-Type” e “Authorization”. A Garmin realiza algumas verificações para impedir o envio de qualquer conteúdo desejado, mas essas regras não estão documentadas oficialmente… Para usar esta opção, configure um string JSON com pares do tipo “nome_do_cabeçalho:conteúdo_do_cabeçalho”. Consulte o site oficial para mais exemplos.
Novidades
╭─── ≡ Nota ╰─ Você pode encontrar a documentação completa e o manual aqui: https://apicall.dumesnil.net ⊕⊕⊕ AVISO ⊕⊕⊕ Vários usuários relataram problemas ao configurar ou atualizar dispositivos da linha GarminExpress. Por favor, prefira usar o sistema connectIQ. Para os relógios compatíveis que possuem apenas 60 KB de memória, nomeadamente: ‣ Fenix5, Quatix5, Fenix5s, FenixChronos ‣ Forerunner245, Forerunner645, Forerunner935 ‣ Venu ‣ Vivoactive3 Nota: As versões “music” não são afetadas. Você pode configurar entre 8 e 15 ações nesses relógios, dependendo da complexidade delas; no entanto, quando a memória estiver completamente ocupada, um triângulo azul aparecerá na tela. Nesse caso, tente limitar o número de ações configuradas. ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.2: Adicionado suporte para os modelos Egde 550, 850 e MTB, Fenix8pro, Venu4 e 1x. ╭─────────────── 1.7.1: Adicionado suporte para os modelos Forerunner® 570 e 970. ╭─────────────── 1.7.0: Alteração na versão principal do SDK, de 7.3 para 8.1. Correção de um erro que ocorria ao usar mais de 10 dispositivos ou 10 ações no mesmo dispositivo. Adicionado suporte para os modelos Descent™ G2, Mk1, Instinct® 3 Amoled (45 e 50 mm), Vivoactive® 6 e Approach® S50. ╭─────────────── 1.6.0: Alteração na versão principal do SDK, de 6.4 para 7.3. ╭─────────────── 1.5.2: Adicionado suporte para os modelos Fēnix® 7pro (sem conexão Wi-Fi), 7Xpro (sem conexão Wi-Fi), Forerunner® 165, 165m e Descent™ Mk3. 1.5.1: Correção de um problema relacionado à opção “headers”; o campo “Content-type” não estava sendo processado corretamente. Adicionado suporte para o modelo Vivoactive5. 1.5.0: Alteração na versão principal do SDK, de 4.2 para 6.4. Adicionado suporte para os modelos Venu® 3/3S. ╭─────────────── As notas de lançamento das versões anteriores estão disponíveis no site oficial.
Análise
Artigo de análise em breve.