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

获取用户详情

开发中
GET
http://localhost:8080/api/v2/user/{uidOrUsername}/detail

请求参数

Path 参数
uidOrUsername
string 
必需
用户 uid 或者 username
Query 参数
whitelistKeys
string 
可选
白名单键名,只返回给定键名的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
blacklistKeys
string 
可选
黑名单键名,从返回数据中删除指定的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
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/user//detail?whitelistKeys=&blacklistKeys=' \
--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 
必需
items
object 
必需
detail
object (User) 
必需
示例
{
    "code": 0,
    "message": "成功",
    "data": {
        "items": {
            "title": null,
            "keywords": null,
            "description": null,
            "manages": []
        },
        "detail": {
            "fsid": "admin",
            "uid": 11182,
            "username": "admin",
            "url": "/u/admin",
            "nickname": "Admin",
            "avatar": "http://localhost:8080/static/images/default-avatar.png",
            "decorate": null,
            "banner": null,
            "gender": 1,
            "birthday": null,
            "bio": null,
            "location": null,
            "conversationLimit": 1,
            "commentLimit": 1,
            "timezone": "+8",
            "verifiedStatus": false,
            "verifiedIcon": null,
            "verifiedDesc": null,
            "verifiedDateTime": null,
            "expired": false,
            "expiryDateTime": null,
            "lastPublishPost": null,
            "lastPublishComment": null,
            "lastEditUsername": null,
            "lastEditNickname": null,
            "registerDate": "2023-03-19 12:47:04",
            "hasPassword": false,
            "rankState": 1,
            "status": true,
            "waitDelete": false,
            "waitDeleteDateTime": null,
            "bioHtml": "",
            "nicknameColor": null,
            "rid": 1,
            "roleName": "管理员",
            "roleNameDisplay": false,
            "roleIcon": null,
            "roleIconDisplay": false,
            "roleExpiryDateTime": null,
            "roleRankState": 1,
            "rolePermissions": {
                "rid": 1,
                "content_view": true,
                "conversation": true,
                "content_link_handle": 3,
                "post_publish": true,
                "post_review": false,
                "post_email_verify": false,
                "post_phone_verify": false,
                "post_real_name_verify": false,
                "post_limit_status": false,
                "post_limit_type": 1,
                "post_limit_period_start": "2022-06-01 22:30:00",
                "post_limit_period_end": "2022-06-06 08:00:00",
                "post_limit_cycle_start": "23:00:00",
                "post_limit_cycle_end": "08:30:00",
                "post_limit_rule": 1,
                "post_second_interval": 60,
                "post_draft_count": 10,
                "comment_publish": true,
                "comment_review": false,
                "comment_email_verify": false,
                "comment_phone_verify": false,
                "comment_real_name_verify": false,
                "comment_limit_status": false,
                "comment_limit_type": 1,
                "comment_limit_period_start": "2022-06-01 22:30:00",
                "comment_limit_period_end": "2022-06-06 08:00:00",
                "comment_limit_cycle_start": "23:00:00",
                "comment_limit_cycle_end": "08:30:00",
                "comment_limit_rule": 1,
                "comment_second_interval": 60,
                "comment_draft_count": 10,
                "post_editor_image": true,
                "post_editor_image_upload_number": 9,
                "post_editor_video": true,
                "post_editor_video_upload_number": 1,
                "post_editor_audio": true,
                "post_editor_audio_upload_number": 2,
                "post_editor_document": true,
                "post_editor_document_upload_number": 10,
                "comment_editor_image": true,
                "comment_editor_image_upload_number": 9,
                "comment_editor_video": false,
                "comment_editor_video_upload_number": 1,
                "comment_editor_audio": false,
                "comment_editor_audio_upload_number": 2,
                "comment_editor_document": false,
                "comment_editor_document_upload_number": 10,
                "image_max_size": 5,
                "video_max_size": 50,
                "video_max_time": 60,
                "audio_max_size": 50,
                "audio_max_time": 60,
                "document_max_size": 10,
                "follow_user_max_count": 500,
                "block_user_max_count": 500,
                "download_file_count": 10
            },
            "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": null,
                "followMeCount": 0,
                "blockMeCount": null,
                "postPublishCount": 0,
                "postDigestCount": 0,
                "postLikeCount": 0,
                "postDislikeCount": null,
                "postFollowCount": 0,
                "postBlockCount": null,
                "commentPublishCount": 0,
                "commentDigestCount": 0,
                "commentLikeCount": 0,
                "commentDislikeCount": null,
                "commentFollowCount": 0,
                "commentBlockCount": null,
                "extcredits1": null,
                "extcredits1Status": 1,
                "extcredits1Name": null,
                "extcredits1Unit": null,
                "extcredits2": null,
                "extcredits2Status": 1,
                "extcredits2Name": null,
                "extcredits2Unit": null,
                "extcredits3": null,
                "extcredits3Status": 1,
                "extcredits3Name": null,
                "extcredits3Unit": null,
                "extcredits4": null,
                "extcredits4Status": 1,
                "extcredits4Name": null,
                "extcredits4Unit": null,
                "extcredits5": null,
                "extcredits5Status": 1,
                "extcredits5Name": null,
                "extcredits5Unit": null
            },
            "archives": [],
            "operations": {
                "customizes": [],
                "buttonIcons": [],
                "diversifyImages": [],
                "tips": []
            },
            "extends": {
                "textBox": [],
                "infoBox": [],
                "interactionBox": []
            },
            "roles": [
                {
                    "rid": 1,
                    "isMain": true,
                    "nicknameColor": null,
                    "name": "管理员",
                    "nameDisplay": false,
                    "icon": null,
                    "iconDisplay": false,
                    "expiryDateTime": null,
                    "rankState": 1,
                    "status": true
                }
            ],
            "interaction": {
                "userName": "用户",
                "userUidName": "用户号",
                "userUsernameName": "用户名",
                "userNicknameName": "昵称",
                "userRoleName": "角色",
                "userBioName": "简介",
                "followSetting": true,
                "followName": "关注",
                "likeSetting": false,
                "likeName": "喜欢",
                "dislikeSetting": false,
                "dislikeName": "不喜欢",
                "blockSetting": false,
                "blockName": "拉黑",
                "publishPostName": "发帖",
                "publishCommentName": "回复",
                "likeStatus": false,
                "dislikeStatus": false,
                "followStatus": false,
                "followMeStatus": false,
                "followNote": null,
                "followExpired": true,
                "followExpiryDateTime": null,
                "blockStatus": false,
                "blockMeStatus": false,
                "blockNote": null
            },
            "conversation": {
                "status": false,
                "code": 36600,
                "message": "对话功能未启用,无法使用"
            }
        }
    }
}
上一页
获取用户列表
下一页
获取用户认识的关注者
Built with