從 Beta 版遷移

本文適用於在 Beta 存取模式下建立的組織——在該模式下,管理員須逐一向每位成員授予權限。存取權限現已改由 Workflow ProfilesAccount Roles 構建,Kraken 將為您自動完成組織轉換。

在轉換前,請注意以下兩項事宜:

  • 如您使用 API 金鑰,請先更新您的整合設定。請求選取帳戶的方式已更改,提款呼叫成功並不代表資金已完成轉移。詳情請參閱下方「更新您的 API 整合設定」。
  • 我們將請您確認已做好準備。您接受變更後,組織才會正式完成轉換。

轉換過程不會移除任何存取權限。每位成員原有的所有權限均會完整保留。

您現有的 API 金鑰不會被撤銷或重新簽發。其登入憑證、權限及帳戶對應關係均會完整保留。改變的是您的程式碼處理請求和讀取回應的方式。

在每個請求中指定帳戶

組織 API 金鑰可涵蓋一個或多個帳戶,且無預設帳戶,因此每個私有請求均須指明所適用的帳戶。請將 account_id 作為查詢參數附加於 URL,而非放入請求正文:

bash

Bash

POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYH

此規則適用於交易、餘額及分類帳查詢、訂單與交易紀錄、匯出,以及資金調撥等所有操作。

注意:

查看新的提款回應

WithdrawFunds 在返回 refid 的同時,亦返回 approval_request_id

bash

Bash

{
  "error": [],
  "result": {
    "refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
    "approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
  }
}
  • refid 不再代表提款已完成。請求提交後,相應金額將在來源帳戶中鎖定,並於請求獲批准後方可結算。
  • approval_request_id 是追蹤該提款審批狀態的識別碼}。請將其與您自身的記錄一併保存。
  • 待審批的提款不會顯示於 WithdrawStatus 中。遭拒絕或已到期的請求不會產生任何提款記錄,因此在 WithdrawStatus 中查無記錄,並不代表提款未曾提交。

若自動化程序將 refid 視為完成憑證,仍在審批佇列中的提款將被錯誤報告為已結算。完整模型詳見 API 金鑰

轉換完成後,您的 Organization 將具備兩組標準元件。

Workflow Profiles

Workflow Profile 定義了成員在每個受管流程中可執行的操作。每位成員只持有一個。

個人資料

所含權限

管理員

所有流程的所有層級,包括 Execute

發起人

所有流程的查看及發起權限。不可審批

Approver

所有流程的查看及審批權限。不可發起

Auditor

所有流程的查看權限。不可操作

Funds Manager

可查看、發起及審批提款請求和轉帳請求。可查看及發起「管理地址」操作

帳戶角色

帳戶角色定義成員可對您的帳戶執行哪些操作。標準角色涵蓋所有現有及日後新增的帳戶。例如,持有 Trade all 角色的成員,即使是您明天才建立的帳戶,同樣可以進行交易。

角色

對每個帳戶授予的權限

Read all

閱讀

Trade all

交易

Funds all

轉帳、提領、理財配置、取消理財配置

完全存取權限

所有帳戶權限

標準設定檔和角色會隨產品持續更新:新增工作流程時,持有相關設定檔或角色的成員將自動獲得相應權限級別。如需完整說明,請參閱 角色、設定檔與權限

若成員的權限與任何標準設定檔均不匹配,系統將為其建立一個角色,完整保留其原有權限。權限完全相同的成員會共用同一個角色,因此您的組織所擁有的角色數量將遠少於成員人數。

這些角色的名稱源自您為成員設定的標籤。例如,標籤為「Trader」的成員,將歸入名為 trader 的角色。沒有標籤的成員將歸入 migrated-role。每個此類角色均帶有 migrated 標記,表示名稱由系統自動生成,您可隨時修改。

貼士:

轉換完成後,最宜先將這些角色重新命名,使其與您對相關人員的實際稱呼一致。編輯角色後,「migrated」標記將自動清除。

為何您的「Admin」成員未歸入 Admin 設定檔

Beta 版的「Admin」標籤允許成員查看、發起及審批,但其自身的請求仍須經過第二次審批方可完成。Admin 設定檔確實包含該能力,即 Execute 級別。

為避免自動授予此權限,系統會將持有舊標籤的成員歸入名為 beta-admin 的角色,該角色僅保留其原有權限。如需將其移至 Admin,只需進行一次角色指派,時間由您決定。

註:

beta-admin 屬於您自訂的角色,因此持有該角色的成員不會像標準設定檔般自動取得新工作流程的權限。這也是建議您在轉換後盡快審查這些角色的原因之一。

擁有者將歸入 Admin 設定檔,保留所有原有設定,並自動取得新工作流程的權限。擁有者同時持有 Read all 角色,此設定無法移除。

若您曾刻意縮減擁有者的權限,該設定將予以保留:擁有者將轉換為持有其實際權限的角色,與其他成員一致。

  • 每位成員原有的所有權限均會完整保留。
  • API 金鑰的登入憑證、權限及帳戶對應均予以保留。
  • 餘額、帳戶及帳戶所有權均維持不變。
  • 進行中的審批請求將繼續處理,您的政策、審批門檻及「永遠要求審批」設定亦保持不變。
  • 身份驗證不受影響,所有人無需重新登入或重新接受邀請。
  • 僅屬於您組織的帳戶會進行轉換。組織以外帳戶的任何權限設定均維持不變。

問題排查

請求很可能缺少 account_id。若未提供此參數,私有呼叫將無法對應至金鑰下的任一帳戶,並可能傳回空結果而非錯誤訊息。請將 account_id 加入 URL,並重新檢查整合所呼叫的每個 API端點,而不僅限於明顯失敗的端點。請參閱 API 金鑰

此呼叫已建立請求,並在來源帳戶鎖定相應金額。審批完成後方可結算。請使用呼叫回傳的 approval_request_id 追蹤請求,或在「請求」頁面查找。請參閱 轉帳與提款

權限與標準設定檔不符的成員,各自需要一個保留其現有存取權限的角色;只有當兩位成員的權限完全相同時,才會合併至同一角色。即使不同標籤的成員權限相同,系統仍會將其保留在各自的角色中,因為不同標籤表示該區分是有意設計的。如有不再需要的角色,可透過重新分配其成員並刪除空角色來進行整合。

負責管理團隊存取權限、帳戶或 API 金鑰的組織管理成員,系統會將其歸入「讀取全部」角色,因為管理帳戶本身即隱含查看帳戶的能力。若此範圍過於寬泛,可將「讀取全部」替換為僅限其所需特定帳戶的帳戶角色。

不。轉換為單向操作,無法還原。轉換後的所有設定均可編輯,您原有的任何存取配置均可透過設定檔和角色重新建立。

需要更多幫助?