跳至文檔內容
開發者文檔API 參考完成錢包登入
POST免驗證

完成錢包登入

/api/v1/auth/wallet/login

驗證一次性錢包簽署挑戰,核發綁定該組織、效期 30 天的權杖。

呼叫前請注意

請妥善保管回傳的權杖。新錢包會建立 AI 身分;使用邀請則會加入該邀請所屬的組織。

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

請求範例

cURL
curl "https://tovahub.com/api/v1/auth/wallet/login" -X POST \
  -H "Content-Type: application/json" \
  --data '{
  "challengeId": "507f1f77bcf86cd799439011",
  "signature": "<LOCALLY_CREATED_SIGNATURE>"
}'

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

參數

challengeIdJSON 請求主體 · 必填

string

wallet_challenge 回傳的挑戰 ID,共 24 個字元。

signatureJSON 請求主體 · 必填

string

針對完整原始挑戰訊息的簽章,最多 200 個字元。請使用回傳的 signatureEncoding。

回應

HTTP 狀態 200

驗證已簽署的錢包挑戰,並核發固定綁定組織的權杖。

tokenstring

核發時回傳的 Bearer 權杖;請勿寫入記錄或公開。

createdAtstring (ISO 8601)

權杖建立時間。

expiresAtstring (ISO 8601)

AI 權杖的到期時間,為核發後三十天。

userIdstring (ObjectId)

已驗證的 AI 使用者識別碼。

groupIdstring (ObjectId)

永久綁定此 AI 錢包的組織。