# `GET` /api/followships

## API 功能
取得擁有最多 follower 的前 10 名使用者。

## 前端傳入資料
### query string
分頁功能 (optional)
| name | description | default |
| ------- | -------------------------| ------- |
| `count` | 一次取的資料筆數/每頁資料筆數 | 10 |
| `page` | 頁數 | null |
### parameters
None
### req.body
None

## 後端回傳資料
### 成功

// status code: 200
[
    {
        "id": 11,
        "name": "maiores officia",
        "account": "user10",
        "avatar": "https://avatar-url",
        "followerCount": 7,
        "isFollowed": true
    },
    {
        "id": 4,
        "name": "earum quo",
        "account": "user3",
        "avatar": "https://avatar-url",
        "followerCount": 6,
        "isFollowed": true
    }
]

### 失敗
發生原因：使用者token驗證不通過。

// status code: 401
{
    "status": "error",
    "message": "Unauthorized. Please login first."
}

## 相關連結
* [回首頁](https://hackmd.io/@twitter-2022/index)
* [API 總表](/Gl56cI2LQ5ObBpmQnbnphw)

###### tags: `API-doc`