Widget
APICall
開発者 CoCoTTe42 · v1.7.2
評価
4.6
レビュー
114
ダウンロード
1,000
価格
無料
説明
╭─── ≡ 一般説明 ╰─ APICallは、スマートフォンを介してBluetoothで、または対応デバイスではWiFi/LTEを使ってHTTP URLを呼び出すためのウィジェットです。 主な用途としては、IoTデバイスやホームオートメーションシステム(Fibaro、eedomus、jeedom、zipa、veraなど)のREST APIを呼び出したり、ifttt.comやzapierなどを通じて他のサービスと連携させたりすることができます。 気に入ったら、ビールをおごってくださいね ;o) → https://paypal.me/apicall → Bitcoin:bc1quuyugk3czzpp4zcr2j9kln4ju6hd9z27ef3y09 Garminではこの説明文の文字数を4,000字に制限していますが、詳細なドキュメントはこちらです: https://apicall.dumesnil.net ╭─── ≡ 使い方 ╰─ ウィジェットを起動したら、「START」または「MENU」ボタンを押します。まずデバイスを選択し、次に実行するアクションを選んだ後で「START」ボタンを押して実行します。実行結果として「OK」やHTMLエラーコードが表示されます。「MENU」ボタンを押すと、別のデバイスやアクションを選択できます。 ※ 注意事項: ‣ 「START」ボタンを押すか、タッチウォッチの場合は画面をタップします。 ‣ 「MENU」ボタンは、右下にあるボタンを長押しするか、画面をタップするなどで使用します。 ╭─── ≡ 設定方法 ╰─ 設定は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 ‣ 説明:このオプションが有効な場合、アクションを選択した直後に自動的に実行されます。`autonext`機能と併用可能です。 • `method` [オプション]: ‣ 型式:文字列 ‣ デフォルト値:「GET」 ‣ 説明:HTTPリクエストの方法を設定します。「GET」「POST」「PUT」から選択できます。 • `POSTcontent` [オプション]: ‣ 型式:文字列 ‣ デフォルト値:"" ‣ 説明:すべてのリクエスト方法(GET、POST、PUT)で使用される内容を設定します。JSON形式の文字列でなければなりません。必要に応じて「」記号をエスケープしてください。例:`{"args":["3"]}`の場合、`POSTcontent:"{"args":["3"]}"`とします。 • `resDisplay` [オプション]: ‣ 型式:文字列 ‣ デフォルト値:"" ‣ 説明:表示するデータを取得するためのJSONパスを設定します。指定しない場合、返信内容として「OK」または「KO」とエラーコードのみが表示されます。「text」と指定した場合、レスポンス内容がそのまま表示されます(レスポンスの長さに注意してください)。例:結果が`{"myres":"xxx"}`の場合、`resDisplay:"myres"`とすると「xxx」が表示されます。 ‣ 例:結果が`{"myres":["id":"xxx", "id":"yyy"]}`の場合、`resDisplay:"myres[0].id"`とすると「id:xxx」が表示されます。 • `media` [オプション]: ‣ 型式:文字列 ‣ デフォルト値:"" ‣ 説明:リクエストを特定の通信手段で実行するよう強制します。設定しない場合、接続されている場合はBT、そうでない場合はWiFi/LTEが使用されます。 • `headers` [オプション]: ‣ 型式:文字列 ‣ デフォルト値:""" ‣ 説明:カスタムのHTTPヘッダーを設定できます。「Content-Type」や「Authorization」といったヘッダーの設定に主に使用されます。Garminでは一部のチェックが行われており、任意のデータを送信することはできない場合もあります…この点についてはドキュメントに記載がありませんので注意してください。「name of the headers":"content of the header」という形式で設定してください。詳細な例はウェブサイトを参照してください。
新機能
╭─── ≡ 注意事項 ╰─ 全てのドキュメントおよびマニュアルはこちらからご覧いただけます: https://apicall.dumesnil.net ⊕⊕⊕ 警告 ⊕⊕⊕ 多くのユーザーから、garminExpressを使用して設定やアップグレードを行う際に問題が発生したとの報告を受けています。できるだけconnectIQをご利用ください。 メモリ容量が60KBしかない対応ウォッチについては、以下の機種が該当します: ‣ fenix5, quatix5, fenix5s, fenixChronos ‣ forerunner245, forerunner645, forerunner935 ‣ venu ‣ vivoactive3 ※ “music”バージョンのウォッチには影響しません。 これらのウォッチでは、設定できるアクションの数はその複雑さに応じて約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個以上のデバイスやアクションを使用する際の不具合を修正。Descent™ G2、Mk1、Instinct® 3 Amoled(45mm/50mm)、Vìvoactive® 6、Approach® S50のサポートを追加。 ╭─────────────── 1.6.0: SDKのメジャーリリースバージョンを6.4から7.3に変更。 ╭─────────────── 1.5.2: Fēnix® 7pro-nonwifi、7Xpro-nonwifi、Forerunner® 165、165m、Descent™ Mk3のサポートを追加。 1.5.1: 「Content-type」オプションに関する問題を修正し、vivoactive5もサポート対象に追加。 1.5.0: SDKのメジャーリリースバージョンを4.2から6.4に変更。Venu® 3/3Sのサポートを追加。 ╭─────────────── 以前のバージョンのリリースノートはウェブサイトでご覧いただけます。
レビュー
レビュー記事は近日公開予定です。