Widget
APICall
开发者 CoCoTTe42 · v1.7.2
评分
4.6
评论
114
下载量
1,000
价格
免费
介绍
╭─── ≡ 基本描述 ╰─ APICall是一款用于通过智能手机借助蓝牙技术，或对于支持WiFi/LTE的设备直接通过这些网络技术来调用HTTP地址的小工具。 它的典型用途是用来调用物联网设备的REST API、家庭自动化设备的相关接口（比如Fibaro、eedomus、jeedom、zipa、vera等设备），或者通过ifttt.com、zapier等平台来实现其他功能。 如果你喜欢这个小工具，记得请我喝杯啤酒哦 ;o) → https://paypal.me/apicall → 比特币支付地址：bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garmin将这个描述字段的长度限制为4,000个字符，完整的文档可以在这里查看： https://apicall.dumesnil.net ╭─── ≡ 使用方法 ╰─ 当你启动这个小工具时，点击“开始”或“菜单”按钮。先选择设备，再选择要执行的操作，最后再次点击“开始”按钮即可执行该操作。系统会显示“成功”或“失败”的提示信息，同时还会显示相应的HTML错误代码。 如果需要选择其他设备或操作，可以点击“菜单”按钮。 注意： ‣ 对于触摸屏手表来说，“开始”操作可以通过点击“开始”按钮来实现，也可以在屏幕上轻触相应区域来触发。 ‣ “菜单”功能可以通过长按右下角的按钮、或者屏幕上的特定区域来调用…… ╭─── ≡ 配置方法 ╰─ 可以在Garmin ConnectIQ应用程序的设置菜单中进行配置。需要设置36条参数，这些参数应该以JSON字符串的形式进行输入。例如： » 基本示例：{deviceName:“Gate”, actionName:“Open”, url:“http://my.url?to=open”} » 带有图标和自动执行下一项操作的示例：{deviceName:“Cinema”, deviceIcon:7, autonext:true, actionName:“TV”, actionIcon:11, url:“http://my.url?tv=on”} • deviceName [必填]： ‣ 类型：字符串 ‣ 说明：用于指定该操作所针对的设备名称。这样可以将多个操作归类到同一设备名下。 • deviceIcon [可选]： ‣ 类型：整数 ‣ 默认值：1 ‣ 说明：用于在设备名称旁边显示对应的图标。 • autonext [可选]： ‣ 类型：布尔值 [true|false] ‣ 默认值：false ‣ 说明：当执行某项操作后，系统会自动选择该设备的下一项可执行操作进行执行。 • actionName [必填]： ‣ 类型：字符串 ‣ 说明：表示要执行的操作的名称。 • actionIcon [可选]： ‣ 类型：整数 ‣ 默认值：2 ‣ 说明：用于在操作名称旁边显示对应的图标。 • url [必填]： ‣ 类型：字符串 ‣ 说明：需要调用的URL地址。 • autolaunch [可选]： ‣ 类型：布尔值 [true|false] ‣ 默认值：false ‣ 说明：如果设置为“true”，则会在选择操作后立即执行该操作。此选项可以与autonext功能一起使用。 • method [可选]： ‣ 类型：字符串 ‣ 默认值：“GET” ‣ 说明：用于指定HTTP请求的类型，可选值有“GET”、“POST”和“PUT”。 • POSTcontent [可选]： ‣ 类型：字符串 ‣ 默认值：“” ‣ 说明：对于所有类型的请求（GET、POST、PUT），都可以将此字段设置为请求内容。内容必须为JSON格式的字符串。如果内容中包含“”字符，需要对其进行转义处理。例如，如果要发送{"args":["3"]}这样的数据，应该写成{POSTcontent:"{"args":["3"]}"}。 • resDisplay [可选]： ‣ 类型：字符串 ‣ 默认值：“” ‣ 说明：用于指定获取返回结果时应该使用的JSON路径。如果未设置此参数，系统只会显示“成功”或“失败”的提示信息以及错误代码。如果设置为“text”，则会以原始格式显示返回结果。例如，如果返回结果是{"myres":"xxx"}，那么就会用resDisplay:“myres”来显示这个结果；如果返回结果是{"myres":["id":"xxx", "id":"yyy"]}, 那么就会用resDisplay:“myres[0].id”来显示。 • media [可选]： ‣ 类型：字符串 ‣ 默认值：“” ‣ 说明：用于指定通过哪种方式发送请求。如果未设置此参数，系统会默认使用蓝牙进行传输；如果已连接WiFi或LTE网络，则会使用这些网络进行传输。 • headers [可选]： ‣ 类型：字符串 ‣ 默认值：“{}” ‣ 说明：允许设置自定义的HTTP头部信息。主要用途是设置“Content-Type”和“Authorization”这两个头部信息。Garmin会对这些头部信息进行一些检查，以防止发送不合法的数据，不过这些检查的具体规则并没有被详细记录下来……要使用这个功能，需要配置一个包含“头部名称”:“头部内容”这样的键值对组成的JSON字符串。更多示例可以访问官方网站查看。
更新内容
╭─── ≡ 备注 ╰─ 您可以在以下链接找到完整的文档和使用手册： https://apicall.dumesnil.net ⊕⊕⊕ 警告 ⊕⊕⊕ 有部分用户反映，在使用garminExpress进行配置或升级时遇到了问题。建议您优先使用connectIQ。 对于那些仅有60KB内存的兼容手表，具体包括： ‣ fenix5、quatix5、fenix5s、fenixChronos ‣ forerunner245、forerunner645、forerunner935 ‣ venu ‣ vivoactive3 请注意：“音乐”版本的手表不受此影响。 根据这些手表的功能复杂程度，您可以在它们上配置8到15个功能，但超过这个数量后内存就会被占满。如果屏幕上出现了倒三角符号，请尝试减少已配置的功能数量。 ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ⊕ ╭─────────────── 1.7.2版本： 新增了对Egde 550、850及MTB系列手表、fenix8pro、venu4以及1x系列手表的支持。 ╭─────────────── 1.7.1版本： 新增了对Forerunner® 570和970系列手表的支持。 ╭─────────────── 1.7.0版本： 对SDK进行了重大升级，版本号从7.3更新为8.1。同时修复了在多台设备上同时使用超过10个功能或在同一设备上使用10个以上功能时出现的故障。新增了对Descent™ G2、Mk1、Instinct® 3 Amoled（45毫米及50毫米款）、Vìvoactive® 6以及Approach® S50系列手表的支持。 ╭─────────────── 1.6.0版本： 将SDK的版本号从6.4更新为7.3。 ╭─────────────── 1.5.2版本： 新增了对Fēnix® 7pro（非Wi-Fi版）、7Xpro（非Wi-Fi版）、Forerunner® 165、165m以及Descent™ Mk3系列手表的支持。 1.5.1版本： 修复了与“头部信息”设置相关的问题，之前“Content-type”字段的处理方式存在错误；同时新增了对vivoactive5系列手表的支持。 1.5.0版本： 将SDK的版本号从4.2更新为6.4，并新增了对Venu® 3/3S系列手表的支持。 ╭─────────────── 旧版本的更新说明可以在官方网站上查看。
评测
评测文章即将上线。