Skip to content
On this page

关注粉丝相关接口

通过用户ID获取关注列表

请求URL

  • http://域名/api/v1/follow/following?uid=用户ID&page=页码&page_size=内容数量

请求方式

  • GET

请求参数

  • 见url

内容数量 0 < 内容数量 < 30

返回示例

json
{
    "code": 200,
    "data": {
        "users": [
            {
                "uid": 1,
                "name": "user_1654250698886",
                "sign": "这个人很懒,什么都没有留下",
                "avatar": "",
                "spacecover": "",
                "gender": 0
            }
        ]
    },
    "msg": "ok"
}

返回参数说明

参数名类型说明
uidint用户ID
namestring用户名
signstring个性签名
avatarstring头像
spacecoverstring用户空间封面图
genderint用户性别,0:未知;1:男;2:女

备注

通过用户ID获取粉丝列表

请求URL

  • http://域名/api/v1/follow/follower?uid=用户ID&page=页码&page_size=内容数量

请求方式

  • GET

请求参数

  • 见url

内容数量 0 < 内容数量 < 30

返回示例

json
{
    "code": 200,
    "data": {
        "users": [
            {
                "uid": 1,
                "name": "user_1654250698886",
                "sign": "这个人很懒,什么都没有留下",
                "avatar": "",
                "spacecover": "",
                "gender": 0
            }
        ]
    },
    "msg": "ok"
}

返回参数说明

参数名类型说明
uidint用户ID
namestring用户名
signstring个性签名
avatarstring头像
spacecoverstring用户空间封面图
genderint用户性别,0:未知;1:男;2:女

备注

通过用户ID获取关注和粉丝数据

请求URL

  • http://域名/api/v1/follow/count?uid=这里写用户ID

请求方式

  • GET

返回示例

json
{
    "code": 200,
    "data": {
        "followers": 1,
        "following": 0
    },
    "msg": "ok"
}

返回参数说明

参数名类型说明
followersint粉丝数
followingint关注数

备注

获取关注状态

请求URL

  • http://域名/api/v1/follow/status?fid=被关注的人的id

请求方式

  • GET

请求头

  • Authorization': access_token

返回示例

json
{
    "code": 200,
    "data": {
        "follow": true,
    },
    "msg": "ok"
}

返回参数说明

参数名类型说明
followbool是否关注

备注

关注用户

请求URL

  • http://域名/api/v1/follow/add

请求方式

  • POST

请求头

  • "content-type": "application/json",
  • Authorization': access_token

参数

参数名必选类型说明
idint目标用户id

返回示例

json
  {
    "code": 200,
    "data": null,
    "msg":"ok"
  }

备注

取消关注用户

请求URL

  • http://域名/api/v1/follow/cancel

请求方式

  • POST

请求头

  • "content-type": "application/json",
  • Authorization': access_token

参数

参数名必选类型说明
idint目标用户id

返回示例

json
  {
    "code": 200,
    "data": null,
    "msg":"ok"
  }

备注

根据 MIT 许可证发布