---
# System prepended metadata

title: '`GET` /api/tweets/:tweet_id/replies'
tags: [API-doc]

---

# `GET` /api/tweets/:tweet_id/replies
<!-- 一級標題自動成為筆記名稱 -->

## API 功能
取得一則貼文的所有回覆。 
* 需註冊才可進入
* 回傳某則推文的所有回覆。
* 資料依照回覆成立時間排序（由新到舊）。  
* 每筆資料中包含
    * reply的資料（id, comment, createdAt）
    * 該則回覆原tweet的作者的id與account（tweetAuthorId, tweetAuthorAccount）
    * reply作者的資料(User.id, User.name, User.account, User.avatar)

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

## 後端回傳資料  
### 成功  
```json
// status code: 200
[
    {
        "id": 334,
        "comment": "test",
        "tweetAuthorId": 2,
        "tweetAuthorAccount": "user1",
        "User": {
            "id": 2,
            "name": "user1",
            "account": "user1",
            "avatar": "https://avatar-url"
        },
        "createdAt": "2022-08-02T13:04:55.000Z"
    },
    {
        "id": 8,
        "comment": "sequi soluta praesentium",
        "tweetAuthorId": 2,
        "tweetAuthorAccount": "user1",
        "User": {
            "id": 4,
            "name": "incidunt aut",
            "account": "user3",
            "avatar": "https://avatar-url"
        },
        "createdAt": "2022-07-28T17:04:14.000Z"
    },
    // ...more replies
]
```

### 失敗  
發生原因：使用者token驗證不通過。
```javascript
// status code: 401
{
    "status": "error",
    "message": "Unauthorized. Please login first."
}
```
發生原因：資料庫沒有資料。
```javascript
// status code: 404
{
    "status": "error",
    "message": "Reply is not found"
}
```


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

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