「API 存取」分頁放的是從網站外面用你的帳號進來的方法。它在設定的「帳號」那一組,排在「用量」後面,網址是 /settings/api-access。分頁上面是「已連結的應用程式」,下面是「個人權杖」。
已連結的應用程式
這份清單列出每一個正在用你的帳號登入的應用程式:網站的手機 App「Cowork Style App」、每一個瀏覽器裡的工作區「Cowork Style 網頁版」,以及你允許過的第三方應用程式。同一個應用程式在兩支手機或兩個瀏覽器登入,就是兩列。
- 欄位是「應用程式」、「權限」、「最近一次取得權杖」與「登入到期時間」。最近換過權杖的應用程式在最上面。
- 應用程式會一直換新的權杖。每換一次,「最近一次取得權杖」就更新,「登入到期時間」也往後延,但它一直是同一列。
- 一個應用程式連續 365 天都沒有用,它的登入就到期,不再出現在清單上。
- 清單上只有你自己的登入。個人權杖不會出現在這裡,它們在下面的「個人權杖」。
- 「Cowork Style 網頁版」最多同時保留 5 個瀏覽器的登入。第 6 個瀏覽器登入時,最久沒有取得權杖的那個瀏覽器的「Cowork Style 網頁版」會結束,它的通知也會停止。那個瀏覽器不會被登出網站。它還開著工作區的頁面時,頁面下次需要權杖就會經過登入頁自動再登入,也會再登記一次通知;沒有開著的話,下次你在那裡打開工作區的任何一頁,它就會經過登入頁自動再登入,也會再登記一次通知。網站的登入還有效時,不需要輸入密碼。
按一列的「撤銷」,會先問「要撤銷「應用程式的名稱」的登入嗎?」,並寫著「撤銷之後,這個應用程式在這裡會被登出。」再按一次「撤銷」,那一列的權杖就不能再用,那個應用程式在那支手機或那個瀏覽器被登出,那支手機或那個瀏覽器也不會再收到你的通知。要再用的話得重新登入。手機遺失時,就在這裡把它登出。
清單打開之後,應用程式換了新的權杖也沒關係,那一列還是同一個登入,按「撤銷」一樣會把它登出。那個登入如果已經結束,例如應用程式自己登出了,按「撤銷」會看到「這一列已經不存在,清單已重新讀取。」,清單也會重新讀取。
「Cowork Style 網頁版」的登入跟著那個瀏覽器的網站登入走,所以撤銷另一個瀏覽器的「Cowork Style 網頁版」時,那個瀏覽器下一次打開網站,就會被登出網站,連「記住我」也會失效,要再用得重新登入。你其他的瀏覽器不受影響。在那之前,你先在那個瀏覽器重新登入的話,它就不會再被登出。撤銷目前這個瀏覽器自己的「Cowork Style 網頁版」時,這個瀏覽器不會被登出網站,工作區的頁面下一次需要權杖時會經過登入頁自動再登入;網站的登入還有效時不需要輸入密碼。清單上又會出現一列。
網站是靠它存在那個瀏覽器裡的一個 Cookie 認出那個瀏覽器。那個 Cookie 被刪掉的話,撤銷之後那個瀏覽器不會被登出網站。
一個瀏覽器有人登入或登出網站時(包括網站只登出那個瀏覽器,例如在那個瀏覽器以 Cowork Style App 登入時),或管理員在那個瀏覽器開始、結束模擬時,那個瀏覽器的每一個「Cowork Style 網頁版」登入都會一起結束,不論是誰的,從清單上消失。結束這些登入不會另外把那個瀏覽器登出網站;之後打開工作區的頁面時,工作區會清掉這個瀏覽器保存的資料,再以網站上目前登入的人重新登入。
管理員在後台模擬你的帳號時(這時使用者選單下方會顯示「結束模擬」)打開過工作區的任何一頁的話,清單上也會有一列「Cowork Style 網頁版」,那是管理員的瀏覽器。撤銷它會結束那一列,但不會把管理員的瀏覽器登出網站;管理員還在模擬的話,頁面下一次需要權杖時會經過登入頁自動再登入,網站的登入還有效時不需要輸入密碼,清單上又會出現一列。管理員在那個瀏覽器開始或結束模擬、登入或登出時,這一列也會結束。這一列不算在上面「Cowork Style 網頁版」的上限裡,也不會因為這個上限而結束。
個人權杖
個人權杖給你自己寫的程式或工具用。程式呼叫網站時帶著它,網站就把這次呼叫當成是你。它能做的事,只有你建立時勾選的權限;它也可以讀取你的名字與電子郵件。沒有勾選「使用你的工作區」時,它不能修改文檔,也不能讀取或修改資料表與工作流;它只有在勾選「在這台裝置讀取你的文件」時,才能讀取文檔的頁面。勾選了「使用你的工作區」,它也不能建立、撤銷或列出權杖。
建立
按「建立個人權杖」,填好下面三項,再按「建立」:
- 「名稱」:一定要填,最多 255 個字。它只是讓你認得這個權杖。
- 「權限」:每一種權限一個勾選框,一開始除了「使用你的工作區」都勾著,至少要勾一個。
- 「期限」:「30 天」、「90 天」、「1 年」與「永不過期」四個選擇,一開始選的是「90 天」。
哪一格沒填好,網站會把原因寫在那一格下面。
管理員在後台模擬你的帳號時,不能替你建立個人權杖:按「建立」會看到「模擬登入時不能建立個人權杖。」,權杖不會建立。
權杖到期的日期寫在權杖裡面。到了那一天,它就不能再用。選「永不過期」的權杖,裡面寫的是 100 年後的日期,清單上顯示「永不過期」。
只顯示這一次
建立之後,會打開「個人權杖已建立」視窗,顯示權杖本身與「複製」按鈕,並寫著「這個權杖只會顯示這一次,請現在複製保存。」按「完成」關掉視窗之後,網站不會再顯示這個權杖本身,清單上只看得到它的名稱、權限與時間。弄丟了的話,撤銷它,再建立一個新的。
程式呼叫網站時,把權杖放在 Authorization 標頭:寫 Bearer,一個空格,再接權杖。
清單
清單列出你每一個還能用的個人權杖,最新的在最上面,欄位是「名稱」、「權限」、「建立時間」與「到期時間」。可以用「搜尋名稱」找名稱。
- 已經撤銷或已經到期的權杖,不會出現在清單上。
- 清單上只有你自己的權杖,別人看不到你的權杖,你也看不到別人的。
- 一個權杖都沒有時,清單寫著「你還沒有個人權杖。按「建立個人權杖」做一個。」
撤銷
按一列的「撤銷」,會先問「要撤銷「權杖的名稱」嗎?」,並寫著「撤銷之後,用這個權杖的程式會立刻不能再呼叫網站,這個動作不能復原。」再按一次「撤銷」,這個權杖就從清單上消失,之後用它的每一次呼叫都會被拒絕。