認證狀態

GET /v1/auth/status

讀取已遮蔽敏感資訊的認證設定，以及 Minara 工作階段與連線狀態。

回應內容

{
  "minara_connected": true,
  "minara_oauth_connected": true,
  "minara_source": "oauth-profile",
  "minara_session": {
    "state": "present",
    "connection": "ready"
  },
  "minara_account_scope": "opaque-account-scope",
  "minara_credential_revision": "opaque-credential-revision"
}

說明

範例僅顯示 Minara 欄位；回應還包含供應商設定和已遮蔽敏感資訊的設定檔。minara_session.state 為 absent、present、reauth_required 或 unknown；獨立的 connection 為 ready、refreshing 或 unavailable。present 表示保留本機授權內容，伺服器此時可能無法存取。unknown 表示憑證暫時無法讀取。選用的 reason 說明明確的拒絕或金鑰儲存問題。連線不可用本身不應觸發登入。

將 minara_account_scope 視為不透明的快取分區識別碼；它變更時清除與帳戶綁定的快取。憑證無法讀取期間可能不回傳該欄位，單憑缺失不能判斷使用者已登出。不要解析它或將它用於認證。舊版連線布林值仍然可用；minara_oauth_connected 明確要求 OAuth 身分，因此 API key 無法解鎖 Web 應用程式。

minara_credential_revision 是目前已套用憑據的不透明版本識別碼，token 輪替、憑據或後端變更、程序重新啟動時會變化；沒有可讀取的憑據時省略。用戶端觀察到已知版本變化後，可讓暫停的讀取請求重新存取伺服器；帳號分區未變時保留快取。版本不變或缺失時，不解除讀取請求暫停。新版本不代表權限提升，伺服器仍可再次要求驗證。不要自動重播失敗的寫入操作，也不要將此識別碼用於認證。