---
title: "friends 获取好友列表"
method: GET
path: "/friends/"
tags: ["好友"]
---

# friends 获取好友列表

`GET /friends/`

获取好友列表

## Headers

- `Authorization` string, required

## Response `200`

ok

- object
  - `code` integer — 状态码
  - `data` ImFriendsImFriends[] — 返回结构数据
    - `created_at` string
    - `form_id` integer
    - `id` integer
    - `note` string
    - `status` integer — 0.未置顶 1.已置顶
    - `to_id` integer
    - `top_time` string
    - `uid` string
    - `updated_at` string
    - `users` ImFriendsImUsers
      - `age` integer
      - `avatar` string
      - `bio` string
      - `client_type` integer
      - `email` string
      - `id` integer
      - `last_login_time` string
      - `name` string
      - `sex` integer
      - `status` integer
      - `uid` string
  - `httpCode` integer — http状态码
  - `message` string — 消息内容

---

[API](https://skmtc.dev/im-tools/apis/im-services.md) · [All operations](https://skmtc.dev/im-tools/apis/im-services/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/im-tools/im-services/revisions/67283dad9bee/schema)