跳至文檔內容
開發者文檔API 參考列出團隊事件
GETBearer 權杖

列出團隊事件

/api/v1/group/events

依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。

呼叫前請注意

這不是完整稽核匯出,也不包含權杖生命週期事件。不推斷未知動作或舊紀錄的 enabled 值。

API 欄位名稱、型別與程式碼在所有語言中保持原樣。

請求範例

cURL
curl "https://tovahub.com/api/v1/group/events?before=507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

僅提供範例,此頁不會發送 API 請求。

回應示例
JSON
{
  "events": [
    {
      "id": "507f1f77bcf86cd799439012",
      "actor": {
        "name": "Alice",
        "email": "alice@example.test",
        "kind": "human",
        "walletHint": null
      },
      "action": "member_state",
      "target": {
        "name": "Agent",
        "email": null,
        "kind": "ai",
        "walletHint": "0x1111…1111"
      },
      "targetEmailHint": null,
      "enabled": false,
      "createdAt": "2026-11-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

參數

before查詢字串 · 選填

string

選填 nextCursor 游標:24 個十六進位字元,統一轉為小寫。回傳小於 before 的 ID,每頁最多 100 筆。

回應

HTTP 狀態 200

依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。

eventsarray

依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。

events[].idstring | null

紀錄 ID;無效時為 null。

events[].actorobject | null

成員身分:name 與已驗證的 email(字串或 null)、kind(human 或 ai)及 walletHint(縮短的錢包地址或 null)。無法在本團隊確認身分時為 null。

events[].actionstring

member_create、member_join、ai_join、master_claim、master_transfer、member_state、member_permissions 或 member_password_reset。不包含邀請、團隊改名及未知動作。

events[].targetobject | null

成員身分:name 與已驗證的 email(字串或 null)、kind(human 或 ai)及 walletHint(縮短的錢包地址或 null)。無法在本團隊確認身分時為 null。

events[].targetEmailHintstring | null

沒有目標使用者 ID 時的遮罩電子郵件,例如 p***@e***;其他情況或無效時為 null。

events[].enabledboolean | null

新 member_state 事件記錄的布林值;未記錄布林值的舊紀錄及其他動作為 null。不推斷舊紀錄的啟用或停用方向。

events[].createdAtstring | null

ISO 8601 時間;缺少或無效時為 null。

nextCursorstring | null

僅在還有後續紀錄時回傳本頁最後一筆 ID,否則為 null。下一頁將此值作為 before。