获取资产分组

GET/v1/asset-groups/{groupId}

获取资产分组。

身份验证

Authorization Bearer — JWT 登录会话或 sk-* API Key。

路径参数

groupIdstringrequired

资产分组 ID。

响应

codeinteger

响应状态码。

dataobject

资产分组详情。

data.assetGroupIdstring

分组公共 ID。

data.sharedboolean

是否已共享给调用方。

data.sharePermissionstring

共享时的权限。

data.shareExpiresAtstring

共享到期时间（存在时）。

data.namestring

分组名称。

data.groupKindstring

分组类型。

data.statusstring

分组状态。

data.verificationStatusstring

REAL_FACE 分组的验证状态（如适用）。

data.activationAllowedboolean

当前是否满足激活条件。

data.activationBlockedReasonstring

无法激活的原因（如适用）。

data.assetCountinteger

分组中的资产数量。

data.h5Linkstring

REAL_FACE 待验证分组的验证链接。

data.defaultUploadTtlDaysinteger

USER_UPLOAD 资源默认过期天数（配置后）。

data.createdAtstring

创建时间。

data.updatedAtstring

更新时间。

msgstring

响应信息。

serviceCodestring | null

失败时的业务码。

请求

Shell

1curl https://api.token360.ai/v1/asset-groups/{groupId} \
2  -H "Authorization: Bearer sk-your-api-key"

响应

JSON

1{
2  "code": 200,
3  "data": {
4    "assetGroupId": "your-asset-group-id",
5    "name": "Marketing Assets",
6    "groupKind": "GENERIC"
7  },
8  "msg": "success"
9}

托管资产配额与生命周期

Virtual Portrait 与 Real Face 上传共享当前个人或租户作用域的托管资产配额。请以查询资产配额返回的结果为准。当前个人作用域默认额度为 50,000，租户作用域默认额度为 500,000；实际配置可能不同。

客户端集成请仅使用 Token360 返回的公开 assetId 和 assetGroupId。

此页面对您有帮助吗？