教你透過快捷指令建立個人健康指標資料庫！

一、背景概述

上一篇文章搞定了蘋果健康應用裡面的存量資料的匯出及轉換格式倒入自己的維格表格（雲端資料庫），本篇完成每天新記錄的健康資料透過【快捷指令】自動化執行上傳同步到維格表格。

本篇主要內容：

1、透過維格表格標準API介面編寫一個快捷指令的思路

2、實現批次蘋果健康資料每天自動化同步到維格表

二、準備內容

快捷指令app

蘋果健康app

ios手機一臺

建立好的健康指標專用維格資料庫

三、過程記錄

1）瞭解維格API與快捷指令URL元件

在維格API裡面咱們只需要用到這個add新增資料這個介面就行，四部分對應內容如圖片所示對應。

什麼是token，是你維格賬戶的唯一金鑰，可以當作是往裡面新增資料的進門鑰匙。所以這塊我單獨拿一個變數進行了儲存，方便把快捷指令分享給他人的時候快速直接複用。

data是顧名思義就是要上傳的資料內容部分，維格限制了一次最多隻能新增10條，咱們就建立一個10條內容的文字進行賦值就行。在執行介面請求的時候需要帶上。

理解了這個關鍵元件使用就可以做很多自己的玩法研究了。

2）設計編寫快捷指令過程及思路

第〇步、驗證官方API的有效性

避免做無用功，第一步永遠是先自己測試一下官方給的介面是否能調通，上網隨便搜一個在HTTP線上除錯工具，也是按請求地址、header、data三部分把內容填進去。

傳送請求後，獲得反饋狀態碼為200表示請求指令執行成功。同時也會返回對應新增內容的一些其他例如新增時間、自增序號之類的屬性欄位。

如果返回狀態碼不是200，可以根據官方的手冊、聯絡客服以及自己檢視程式碼格式等形式找到問題（我就多了一個逗號報錯半天），減少後期在快捷指令中出現問題的風險。

第一步、獲取正確的健康樣本資料

因為目的功能非常明確，就是要做一個每天晚上同步手機裡的健康資料的自動化捷徑。所以取到正確健康資料很關鍵。然後才是把資料上傳等操作。

我是之前在寫格志日記就熟練使用這部分的健康資料查詢使用了，但是不妨記錄一下思路。

1、先在蘋果健康中找到想要記錄的身體指標，檢視所記錄的資料詳情。

以睡眠為例子，裡面都是一段一段的持續時間。

2、所以第二個就是從樣本資料中獲取持續時間

例如步數就是獲取值、心率也是獲取值

3、對獲取的陣列內容做預處理

睡眠就是把各段睡眠持續時常做累加即可，但是最高心率就是取最大值，最低心率就是取最小值。

4、對獲取的資料做單位轉換

大部分健康資料都可以透過累加綜合等方式就能直接使用，但是睡眠需要做單位轉換。

把獲得的持續時間觀察一下就知道是多個以秒為單位的時間。

從秒的數值轉換為x小時x分。我用了一個笨辦法，先把累加計算的結果除3600，取整數，就是小時數然後設定小時變數，完了再用除3600的結果減去設定變數的小時變數就能得到0。幾的小時直接再乘一個60就能得到分鐘數，再設定一個分鐘變數。2個變數數文字一拼就是昨晚的睡眠資料了。

5、最後一直調整到能得到想要形態的結果資料

然後按同樣的方法嘗試其他型別指標的提取方式或辦法，目測應該沒有比睡眠時長更麻煩的了，其他的都很簡單。

第二步、實現一個最小樣本資料上傳

有了前兩步的積累就能實現一次快速的單健康資料同步上傳了。

把從健康中獲得資料結果賦值一個變數，然後直接填到對應的URL資料中，執行快捷指令。檢視返回結果是不是200，同時登陸PC端的維格資料表檢視是否確實資料更新到位。沒問題就實現了一個最小MVP。

第三步、編寫完整的快捷指令程式

這部分就比較枯燥了因為介面限制是批次新增最多10條，所以咱們就充分利用十條，建立10個健康資料獲取的程式塊，分佈賦值指標1-10，然後data資料文字也擴充為10條記錄。

之前有一個小偉大神開發的快捷指令複製捷徑，現在已經失效了，只能用目前我能找到最快的方法：用IPAD編寫，透過右側收藏列表，快速拖拽需要的元件到程式序列中，但是偏偏ipad端又是沒有健康app的，最後還得回到手機端再挨個設定裡面的細項，大概花了1小時做這個事。

第四步、最佳化快捷指令程式使用體驗

1、提取賦值變數做公共詞典

在第三步我所有的指標名稱都是直接寫死在data的文字框裡面的，如果要修改起來是比較麻煩的，包括請求地址和token其實都是自定義文字的賦值，我就乾脆設定了一個詞典，然後在data文字中直接使用詞典中指定鍵值。在開篇完成相應的定義，方便自己清晰總覽同時被他人個性化使用。

2、給執行結果新增提醒反饋

簡單寫一個如果否則的判斷程式，對提交URL請求後返回的內容做一個展示。如果成功直接告訴已經上傳成功的結果，失敗往前臺透出相應的錯誤狀態碼詳情及說明。

方便使用中定位問題。

3）設定自動化執行捷徑

這部分應該還有坑，因為薄荷健康都是12點定時同步資料到蘋果健康的，也就是12點之後才能拿到前一天的資料，所以我取的都是最近1天的資料，而不是「在今天」的資料，然後配合運動手錶的健康運動的app，需要每天開啟之後才能透過藍芽同步資料，需要在往維格上傳之前先把手錶的資料同步都手機上先，可以做成一連串的自動開啟應用，再關閉，最後再開同步。

還經常有奇怪的地方會卡住。等我研究透再稿一篇好了。實在不好自動化每天早上起床關掉鬧鐘後，手動點選一下執行同步健康資料的快捷指令也行，剛好拿到完整的睡眠資料。

四、心得體會

1、我會把寫完的快捷指令分享出來，關注我賬號私信回覆關鍵詞“

維格健康

”給您傳送本文完成的快捷指令的下載連結。您可以個性化編輯修改為己所用。

2、除了這種定期同步每天會產生的健康指標之外，還有一些例如不定期的測尿酸，測血壓，體重，體脂及運動記錄也可以用類似的快捷指令元件完成資料的記錄，但沒必要每日同步上傳了。

3、有了存量健康資料、及每天同步的新資料，下一步就可以搭建「健康指標數字駕駛艙」。

曾創業四年，期間全年無休住辦公室，工作內容涵蓋了弱電、開發、產品、UI、測試、運營、售前、售後、專案管理、財務、人力等填坑經歷，企業最高估值過千萬。

變身打工人後，充分發揮分身能力，投身興趣；曾兼任新華三大學《時間管理》課程內訓講師。

現於500強能源企業中任職IT產品經理，同是少數派matrix簽約作者。