---
# System prepended metadata

title: '`GET` /api/users/:id/replied_tweets'
tags: [API-doc]

---

# `GET` /api/users/:id/replied_tweets 

## API 功能
取得某位使用者發過回覆的推文。 
* 需註冊才可進入。只有role為user。
* 回傳某位使用者發過的reply。
* 資料依照reply成立時間排序（由新到舊）。  
* 每筆reply資料中包含
    * reply的作者資料（id, name, account, avatar）
    * 該筆reply的原tweet的資料(id)、tweet的作者資料(id, name, account)

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

## 後端回傳資料  
### 成功  
```json
// status code: 200
// id: 4
[
    {
        "id": 15,
        "comment": "nihil quo est",
        "createdAt": "2022-07-28T17:52:29.000Z",
        "User": { // reply作者
            "id": 4,
            "name": "user3",
            "account": "user3",
            "avatar": "https://avatar-url"
        },
        "Tweet": {
            "id": 5,
            "User": { // reply的原tweet作者
                "id": 2,
                "name": "user1",
                "account": "user1"
            }
        }
    },
    {
        "id": 33,
        "comment": "laboriosam quibusdam assumenda",
        "createdAt": "2022-07-28T16:07:39.000Z",
        "User": {
            "id": 4,
            "name": "user3",
            "account": "user3",
            "avatar": "https://avatar-url"
        },
        "Tweet": {
            "id": 11,
            "User": {
                "id": 3,
                "name": "user2",
                "account": "user2"
            }
        }
    },
    // ...more replies
]
```

### 失敗  
發生原因：使用者 token 驗證不通過。
```javascript
// status code: 401
{
    "status": "error",
    "message": "Unauthorized. Please login first."
}
```
發生原因：找不到與傳入 `id` 對應的 user。
```javascript
// status code: 404
{
    "status": "error",
    "message": "User is not found"
}
```


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

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