外观
创建站内分享(同 (resource, grantee) 已存在活跃 grant 时语义为覆盖更新)
POST
/v1/share-grants/save
授权
apiKey
类型
API Key (header: Authorization)
参数
请求头参数
X-Atk-User-Token
强通道:系统自签的不透明用户会话 token,用于 Client 代表用户调用。 与 X-Atk-Act-As-Source / X-Atk-Act-As-Source-Id 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source
弱通道:身份 source 主张(要求 Client 已开启 actAsAllowed)。 必须与 X-Atk-Act-As-Source-Id 成对携带,缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS;与 X-Atk-User-Token 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source-Id
弱通道:身份 sourceId 主张(要求 Client 已开启 actAsAllowed)。 必须与 X-Atk-Act-As-Source 成对携带,缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS;与 X-Atk-User-Token 互斥,同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
请求体
application/json
JSON "resourceType": "string", "resourceId": "string", "grantee": { "granteeType": "string", "granteeId": "string" }, "permissionPreset": "string", "expiresAt": "string", "message": "string"
{
}
响应
OK
*/*
JSON "code": 0, "data": { "shareGrantId": "string", "resourceType": "string", "resourceId": "string", "grantorId": "string", "granteeType": "string", "granteeId": "string", "permissionPreset": "string", "message": "string", "expiresAt": "string", "revokedAt": "string", "status": "string", "createTime": "string" }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}