fresns
  1. 公共业务
fresns
  • 请求标头
  • 通用数据结构
  • 错误码
  • 全局配置
    • 全局配置信息
      GET
    • 状态码信息
      GET
    • 扩展档案配置
      GET
    • 上传用的令牌
      GET
    • 用户角色
      GET
    • 地图服务商
      GET
    • 内容类型
      GET
    • 表情图
      GET
    • 阻止词
      GET
  • 公共业务
    • 输入提示信息
      GET
    • 回调返参查询
      GET
    • 发送验证码
      POST
    • 上传日志
      POST
    • 上传文件
      POST
    • 文件下载链接
      GET
    • 下载过文件的用户
      GET
  • 账号
    • 注册
      POST
    • 登录
      POST
    • 重置密码
      PUT
    • 获取账号详情
      GET
    • 钱包交易记录
      GET
    • 身份验证
      POST
    • 修改账号资料
      PUT
    • 退出登录
      DELETE
    • 申请删除账号
      POST
    • 撤销删除申请
      POST
  • 用户
    • 获取用户列表
    • 获取用户详情
    • 获取用户认识的关注者
    • 获取用户互动的用户列表
    • 获取用户标记的内容列表
    • 用户登录
    • 用户面板
    • 修改用户资料
    • 操作标记
    • 标记备注
  • 消息
    • [通知]获取消息列表
    • [通知]更新阅读状态
    • [通知]删除消息
    • [对话]获取对话列表
    • [对话]获取对话详情
    • [对话]获取消息列表
    • [对话]置顶对话
    • [对话]更新阅读状态
    • [对话]发送消息
    • [对话]删除对话或对话的消息
  • 小组
    • 获取树结构小组列表
    • 获取小组分类
    • 获取小组列表
    • 获取小组详情
    • 获取小组互动的用户列表
  • 话题
    • 获取话题列表
    • 获取话题详情
    • 获取话题互动的用户列表
  • 帖子
    • 获取帖子列表
    • 获取关注对象的帖子列表
    • 获取位置附近的帖子列表
    • 获取帖子详情
    • 获取帖子互动的用户列表
    • 获取帖子的附属用户列表
    • 获取帖子的日志列表
    • 获取帖子日志详情
    • 删除帖子
  • 评论
    • 获取评论列表
    • 获取关注对象的评论列表
    • 获取位置附近的评论列表
    • 获取评论详情
    • 获取评论互动的用户列表
    • 获取评论的日志列表
    • 获取评论日志详情
    • 删除评论
  • 编辑器
    • 快速发表(帖子)
    • 快速发表(评论)
    • 编辑器配置信息
    • 获取草稿列表(帖子)
    • 获取草稿列表(评论)
    • 创建草稿(帖子)
    • 创建草稿(评论)
    • 生成编辑草稿(帖子)
    • 生成编辑草稿(评论)
    • 获取草稿详情(帖子)
    • 获取草稿详情(评论)
    • 更新草稿内容(帖子)
    • 更新草稿内容(评论)
    • 提交发表(或审核)
    • 撤回审核中草稿
    • 删除草稿
  • 搜索
    • 用户
    • 小组
    • 话题
    • 帖子
    • 评论
  1. 公共业务

下载过文件的用户

开发中
GET
http://localhost:8080/api/v2/common/file/{fid}/users

请求参数

Path 参数
fid
string 
必需
要下载的文件 FID
Query 参数
whitelistKeys
string 
可选
白名单键名,只返回给定键名的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
blacklistKeys
string 
可选
黑名单键名,从返回数据中删除指定的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
pageSize
string 
可选
每页显示条数(默认 15 条)
page
string 
页码(默认 1)
可选
Header 参数
X-Fresns-App-Id
string 
必需
密钥 App ID
密钥位置:控制面板->应用中心->应用密钥
默认值:
{{appId}}
X-Fresns-Client-Platform-Id
integer 
必需
平台编号,与密钥的「平台」匹配
默认值:
{{clientPlatformId}}
X-Fresns-Client-Version
string 
必需
你的客户端版本号,推荐使用语义化版本号
默认值:
{{clientVersion}}
X-Fresns-Client-Device-Info
string 
必需
交互设备信息 session_logs > device_info
压缩 Object 信息为字符串传参
默认值:
{{clientDeviceInfo}}
X-Fresns-Aid
string 
可选
账号参数(留空则视为未登录账号)
默认值:
{{aid}}
X-Fresns-Aid-Token
string 
可选
账号身份凭证(传参 aid 时必传)
默认值:
{{aidToken}}
X-Fresns-Uid
integer 
可选
用户参数(留空则视为未登录用户)
默认值:
{{uid}}
X-Fresns-Uid-Token
string 
可选
用户身份凭证(传参 uid 时必传)
默认值:
{{uidToken}}
X-Fresns-Signature
string 
签名
必需
X-Fresns-Signature-Timestamp
string 
必需
签名生成时间(当前 Unix 时间戳,精确到秒或毫秒都支持)

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:8080/api/v2/common/file//users?whitelistKeys=&blacklistKeys=&pageSize=&page=' \
--header 'X-Fresns-App-Id;' \
--header 'X-Fresns-Client-Platform-Id;' \
--header 'X-Fresns-Client-Version;' \
--header 'X-Fresns-Client-Device-Info;' \
--header 'X-Fresns-Aid: ' \
--header 'X-Fresns-Aid-Token: ' \
--header 'X-Fresns-Uid: ' \
--header 'X-Fresns-Uid-Token: ' \
--header 'X-Fresns-Signature;' \
--header 'X-Fresns-Signature-Timestamp;'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
object 
必需
pagination
object (Pagination) 
必需
list
array [object {3}] 
必需
示例
{
    "code": 0,
    "message": "string",
    "data": {
        "pagination": {
            "total": 0,
            "pageSize": 0,
            "currentPage": 0,
            "lastPage": 0
        },
        "list": [
            {
                "downloadTime": "string",
                "downloadTimeFormat": "string",
                "downloadUser": {
                    "fsid": "string",
                    "uid": 0,
                    "username": "string",
                    "url": "string",
                    "nickname": "string",
                    "avatar": "string",
                    "decorate": "string",
                    "banner": "string",
                    "gender": 0,
                    "birthday": "string",
                    "bio": "string",
                    "bioHtml": "string",
                    "location": "string",
                    "conversationLimit": 0,
                    "commentLimit": 0,
                    "timezone": "string",
                    "verifiedStatus": true,
                    "verifiedIcon": "string",
                    "verifiedDesc": "string",
                    "verifiedDateTime": "string",
                    "expired": true,
                    "expiryDateTime": "string",
                    "lastPublishPost": "string",
                    "lastPublishComment": "string",
                    "lastEditUsername": "string",
                    "lastEditNickname": "string",
                    "registerDate": "string",
                    "hasPassword": true,
                    "rankState": 0,
                    "status": true,
                    "waitDelete": true,
                    "waitDeleteDateTime": "string",
                    "nicknameColor": "string",
                    "rid": 0,
                    "roleName": "string",
                    "roleNameDisplay": true,
                    "roleIcon": "string",
                    "roleIconDisplay": true,
                    "roleExpiryDateTime": "string",
                    "roleRankState": 0,
                    "rolePermissions": {},
                    "roleStatus": true,
                    "stats": {
                        "likeUserCount": 0,
                        "likeGroupCount": 0,
                        "likeHashtagCount": 0,
                        "likePostCount": 0,
                        "likeCommentCount": 0,
                        "dislikeUserCount": 0,
                        "dislikeGroupCount": 0,
                        "dislikeHashtagCount": 0,
                        "dislikePostCount": 0,
                        "dislikeCommentCount": 0,
                        "followUserCount": 0,
                        "followGroupCount": 0,
                        "followHashtagCount": 0,
                        "followPostCount": 0,
                        "followCommentCount": 0,
                        "blockUserCount": 0,
                        "blockGroupCount": 0,
                        "blockHashtagCount": 0,
                        "blockPostCount": 0,
                        "blockCommentCount": 0,
                        "likeMeCount": 0,
                        "dislikeMeCount": 0,
                        "followMeCount": 0,
                        "blockMeCount": 0,
                        "postPublishCount": 0,
                        "postDigestCount": 0,
                        "postLikeCount": 0,
                        "postDislikeCount": 0,
                        "postFollowCount": 0,
                        "postBlockCount": 0,
                        "commentPublishCount": 0,
                        "commentDigestCount": 0,
                        "commentLikeCount": 0,
                        "commentDislikeCount": 0,
                        "commentFollowCount": 0,
                        "commentBlockCount": 0,
                        "extcredits1": 0,
                        "extcredits1Status": 0,
                        "extcredits1Name": "string",
                        "extcredits1Unit": "string",
                        "extcredits2": 0,
                        "extcredits2Status": 0,
                        "extcredits2Name": "string",
                        "extcredits2Unit": "string",
                        "extcredits3": 0,
                        "extcredits3Status": 0,
                        "extcredits3Name": "string",
                        "extcredits3Unit": "string",
                        "extcredits4": 0,
                        "extcredits4Status": 0,
                        "extcredits4Name": "string",
                        "extcredits4Unit": "string",
                        "extcredits5": 0,
                        "extcredits5Status": 0,
                        "extcredits5Name": "string",
                        "extcredits5Unit": "string"
                    },
                    "archives": [
                        {
                            "code": "string",
                            "name": "string",
                            "description": "string",
                            "value": "string"
                        }
                    ],
                    "operations": {
                        "customizes": [
                            {
                                "code": "string",
                                "style": "string",
                                "name": "string",
                                "description": "string",
                                "imageUrl": "string",
                                "imageActiveUrl": "string",
                                "displayType": 0,
                                "pluginUrl": "string"
                            }
                        ],
                        "buttonIcons": [
                            {
                                "code": "string",
                                "style": "string",
                                "name": "string",
                                "description": "string",
                                "imageUrl": "string",
                                "imageActiveUrl": "string",
                                "displayType": 0,
                                "pluginUrl": "string"
                            }
                        ],
                        "diversifyImages": [
                            {
                                "code": "string",
                                "style": "string",
                                "name": "string",
                                "description": "string",
                                "imageUrl": "string",
                                "imageActiveUrl": "string",
                                "displayType": 0,
                                "pluginUrl": "string"
                            }
                        ],
                        "tips": [
                            {
                                "code": "string",
                                "style": "string",
                                "name": "string",
                                "description": "string",
                                "imageUrl": "string",
                                "imageActiveUrl": "string",
                                "displayType": 0,
                                "pluginUrl": "string"
                            }
                        ]
                    },
                    "extends": {
                        "textBox": [
                            {
                                "eid": "string",
                                "type": 0,
                                "textContent": "string",
                                "textIsMarkdown": true,
                                "infoType": 0,
                                "infoTypeString": "string",
                                "cover": "string",
                                "title": "string",
                                "titleColor": "string",
                                "descPrimary": "string",
                                "descPrimaryColor": "string",
                                "descSecondary": "string",
                                "descSecondaryColor": "string",
                                "buttonName": "string",
                                "buttonColor": "string",
                                "position": 0,
                                "accessUrl": "string"
                            }
                        ],
                        "infoBox": [
                            {
                                "eid": "string",
                                "type": 0,
                                "textContent": "string",
                                "textIsMarkdown": true,
                                "infoType": 0,
                                "infoTypeString": "string",
                                "cover": "string",
                                "title": "string",
                                "titleColor": "string",
                                "descPrimary": "string",
                                "descPrimaryColor": "string",
                                "descSecondary": "string",
                                "descSecondaryColor": "string",
                                "buttonName": "string",
                                "buttonColor": "string",
                                "position": 0,
                                "accessUrl": "string"
                            }
                        ],
                        "interactionBox": [
                            {
                                "eid": "string",
                                "type": 0,
                                "textContent": "string",
                                "textIsMarkdown": true,
                                "infoType": 0,
                                "infoTypeString": "string",
                                "cover": "string",
                                "title": "string",
                                "titleColor": "string",
                                "descPrimary": "string",
                                "descPrimaryColor": "string",
                                "descSecondary": "string",
                                "descSecondaryColor": "string",
                                "buttonName": "string",
                                "buttonColor": "string",
                                "position": 0,
                                "accessUrl": "string"
                            }
                        ]
                    },
                    "roles": [
                        {
                            "rid": 0,
                            "isMain": true,
                            "nicknameColor": "string",
                            "name": "string",
                            "nameDisplay": true,
                            "icon": "string",
                            "iconDisplay": true,
                            "permission": {},
                            "status": true
                        }
                    ],
                    "interaction": {
                        "userName": "string",
                        "userUidName": "string",
                        "userUsernameName": "string",
                        "userNicknameName": "string",
                        "userRoleName": "string",
                        "userBioName": "string",
                        "likeSetting": true,
                        "likeName": "string",
                        "dislikeSetting": true,
                        "dislikeName": "string",
                        "followSetting": true,
                        "followName": "string",
                        "blockSetting": true,
                        "blockName": "string",
                        "publishPostName": "string",
                        "publishCommentName": "string",
                        "likeStatus": true,
                        "dislikeStatus": true,
                        "followStatus": true,
                        "followMeStatus": true,
                        "followNote": "string",
                        "blockStatus": true,
                        "blockMeStatus": true,
                        "blockNote": "string"
                    },
                    "conversation": {
                        "status": true,
                        "code": 0,
                        "message": "string"
                    }
                }
            }
        ]
    }
}
上一页
文件下载链接
下一页
注册
Built with