Skip to content
On this page

File Download Users

  • Endpoint Path: /api/v2/common/file/{fid}/users
  • Method: GET
  • Request: Rest + Query

Headers Optional Parameter

Parameter NamePublic Mode (Required)Private Mode (Required)
X-Fresns-Aidrequiredrequired
X-Fresns-Aid-Tokenrequiredrequired
X-Fresns-Uidrequiredrequired
X-Fresns-Uid-Tokenrequiredrequired

Rest Params

Parameter NameTypeRequiredDescription
fidStringrequired要下载的文件 FID

Query Params

Parameter NameTypeRequiredDescription
whitelistKeysStringoptional白名单键名,只返回给定键名的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
blacklistKeysStringoptional黑名单键名,从返回数据中删除指定的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
pageSizeNumberoptional每页显示条数(默认 15 条)
pageNumberoptional页码(默认 1)

Return

json
{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "Number / How much data in total",
            "pageSize": "Number / How much data on each page",
            "currentPage": "Number / Current page number",
            "lastPage": "Number / Last page number"
        },
        "list": [
            {
                "downloadTime": "String / 下载时间",
                "downloadTimeFormat": "String / 下载时间",
                "downloadUser": {
                    // Common Data Structure -> User Info
                }
            }
        ]
    }
}

Released under the Apache-2.0 License