---
# System prepended metadata

title: Makesound API 文件

---

# Makesound API 文件

## API Details & Examples

### User

#### 註冊使用者

Request Example

```json
{
    "fullname": "fullname",
    "username": "username",
    "nickname": "nickname",
    "password": "password"
}
```

Response Example

```json
{
    "ok": 1,
    "message": "Register success",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InVzZXJuYW1lIiwiaWF0IjoxNzAyMjk4Nzk3LCJleHAiOjM0MDcxODk1OTR9.YjXYtWiItSDMfj-BHr4g64lOjIF5xpmnGst1i26AQ1I"
}
```

#### 登入使用者

Request Example

```json
{
    "username": "username",
    "password": "password"
}
```

Response Example

```json
{
    "ok": 1,
    "message": "Login success",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InVzZXJuYW1lIiwiaWF0IjoxNzAyMjk4OTExLCJleHAiOjM0MDcxODk4MjJ9.M_qdFAWbzug3DyQuxBnL3wLNDMgBksQxBfZFDNBuYi8"
}
```

#### 登出使用者

Response Example

```json
{
    "ok": 1,
    "message": "Hope to see you soon"
}
```

#### 取得個人資料

Response Example

```json
{
    "ok": 1,
    "data": {
        "userId": 1702298797,
        "fullname": "fullname",
        "username": "username",
        "nickname": "nickname",
        "avatar": null,
        "location": null,
        "gender": null,
        "birth": null,
        "introduce": null,
        "role": "user"
    }
}
```

#### 更新個人資料

Request Example

```json
{
    "introduction": "hello"
}
```

Response Example

```json
{
    "ok": 1,
    "message": "User update personal information success"
}
```

#### 更新個人密碼

Request Example

```json
{
    "oldPassword": "password",
    "newPassword": "newPassword",
    "confirmPassword": "newPassword"
}
```

Response Example

```json
{
    "ok": 1,
    "message": "User update password success"
}
```

#### 刪除會員帳號

Response Example

```json
{
  "ok": 1,
  "message": "User has been deleted own account",
}
```

### Song

#### 取得所有歌曲

Response Example

```json
{
    "ok": 1,
    "count": 5,
    "songs": [
        {
            "id": 1,
            "songId": 1702232051,
            "userId": 10,
            "title": "日常守護者",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/an/ti/anti_talent/5X4BpATVcCWdC2HwuGQKFd.mp3",
            "cover": "https://akstatic.streetvoice.com/song_covers/an/ti/anti_talent/AMKZ8gbsh999itM8a9TXJ2.jpeg?x-oss-process=image/resize,m_fill,h_380,w_380,limit_0/interlace,1/quality,q_95/sharpen,80/format,jpg",
            "playCount": 6085,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 2,
            "songId": 1702232058,
            "userId": 10,
            "title": "我沒有太多",
            "genre": "rap",
            "track": "https://akhls.streetvoice.com/music/_p/e6/_pe630arl/5RWDjfJdZKXZurVT6U8zrw.mp3",
            "cover": "https://images.unsplash.com/photo-1454923634634-bd1614719a7b?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 456,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 3,
            "songId": 1702232078,
            "userId": 11,
            "title": "好小孩 demo1",
            "genre": "rap",
            "track": "\"https://akhls.streetvoice.com/music/an/ti/anti_talent/c7QsBZWen5qKtHbujvnxUB.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1665941065977-993d9105662a?q=80&w=1886&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 3366,
            "UserId": 11,
            "User": {
                "id": 11,
                "username": "_pe630arl",
                "nickname": "方品融",
                "avatar": "https://images.unsplash.com/photo-1534528741775-53994a69daeb?q=80&w=1964&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 4,
            "songId": 1702232138,
            "userId": 12,
            "title": "My Own Pace",
            "genre": "rap",
            "track": "https://akhls.streetvoice.com/music/an/ti/anti_talent/eb8eBpysqDjUes92SCa4rJ.mp3",
            "cover": "https://images.unsplash.com/photo-1517732306149-e8f829eb588a?q=80&w=2072&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 6491,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 5,
            "songId": 1702232225,
            "userId": 12,
            "title": "凌晨幾點",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/Di/nn/Dinner_Salute/gnpevBmk84iWXL99jqpPko.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1664879730345-ae3381805040?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 4567,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
    ]
}
```

#### 取得熱門歌曲

Response Example

```json
{
    "ok": 1,
    "count": 5,
    "songs": [
        {
            "id": 6,
            "songId": 1702232789,
            "userId": 11,
            "title": "還不夠多",
            "genre": "Rock",
            "track": "https://akhls.streetvoice.com/music/il/ov/ilovefunk_0407/M5JUzWpWHkNkMbhCSEXecm.mp3",
            "cover": "https://images.unsplash.com/photo-1553530979-fbb9e4aee36f?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDF8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 99632,
            "UserId": 11,
            "User": {
                "id": 11,
                "username": "_pe630arl",
                "nickname": "方品融",
                "avatar": "https://images.unsplash.com/photo-1534528741775-53994a69daeb?q=80&w=1964&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 9,
            "songId": 1702231674,
            "userId": 10,
            "title": "讓我陪你去旅行",
            "genre": "folk",
            "track": "https://akhls.streetvoice.com/music/lo/st/loststar926/Xefarvbsoh7YC3UhU4SZo3.mp3",
            "cover": "https://images.unsplash.com/photo-1488161628813-04466f872be2?q=80&w=1964&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 64711,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 7,
            "songId": 1702232652,
            "userId": 11,
            "title": "變形蟲",
            "genre": "Rock",
            "track": "https://akhls.streetvoice.com/music/Si/le/Silent_Gentlemen/WQ3AzqXTixwAaHyBe9C8UE.mp3",
            "cover": "https://images.unsplash.com/photo-1539571696357-5a69c17a67c6?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 20579,
            "UserId": 11,
            "User": {
                "id": 11,
                "username": "_pe630arl",
                "nickname": "方品融",
                "avatar": "https://images.unsplash.com/photo-1534528741775-53994a69daeb?q=80&w=1964&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 10,
            "songId": 1702237289,
            "userId": 10,
            "title": "戒了你 Not Bad",
            "genre": "electronic",
            "track": "https://akhls.streetvoice.com/music/ma/de/madeinbackstation/YAqtxLcbhZKJvfdhEBYTjM.mp3",
            "cover": "https://images.unsplash.com/photo-1659482633371-c51d3a02bc81?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDF8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 9124,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 8,
            "songId": 1702232581,
            "userId": 12,
            "title": "你想要的 我給不起",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/ro/be/roberthu0410/KWrDG8JK3rntwEbERTaJoz.mp3",
            "cover": "https://images.unsplash.com/photo-1517841905240-472988babdf9?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 7681,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
    ]
}
```

#### 取得熱門歌曲（曲風）

Response Example

```json
{
    "ok": 1,
    "count": 4,
    "songs": [
        {
            "id": 8,
            "songId": 1702232581,
            "userId": 12,
            "title": "你想要的 我給不起",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/ro/be/roberthu0410/KWrDG8JK3rntwEbERTaJoz.mp3",
            "cover": "https://images.unsplash.com/photo-1517841905240-472988babdf9?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 7681,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 1,
            "songId": 1702232051,
            "userId": 10,
            "title": "日常守護者",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/an/ti/anti_talent/5X4BpATVcCWdC2HwuGQKFd.mp3",
            "cover": "https://akstatic.streetvoice.com/song_covers/an/ti/anti_talent/AMKZ8gbsh999itM8a9TXJ2.jpeg?x-oss-process=image/resize,m_fill,h_380,w_380,limit_0/interlace,1/quality,q_95/sharpen,80/format,jpg",
            "playCount": 6085,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 5,
            "songId": 1702232225,
            "userId": 12,
            "title": "凌晨幾點",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/Di/nn/Dinner_Salute/gnpevBmk84iWXL99jqpPko.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1664879730345-ae3381805040?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 4567,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 13,
            "songId": 1702257537,
            "userId": 4,
            "title": "Welcome to Christmas",
            "genre": "pop",
            "track": "https://akhls.streetvoice.com/music/sw/ee/sweetmachine/PEHEN4kkATEKsechmzzBbY.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1682681907111-c13bc10b1587?q=80&w=1888&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        }
    ]
}
```

#### 取得最新歌曲

Response Example

```json
{
    "ok": 1,
    "count": 14,
    "songs": [
        {
            "id": 16,
            "songId": 1702271708,
            "userId": 4,
            "title": "很抱歉",
            "genre": "electronic",
            "track": "https://akhls.streetvoice.com/music/an/gi/angie_su/fbZa8t2sXFiRpXn3rovhiQ.mp3",
            "cover": "https://images.unsplash.com/photo-1513171920216-2640b288471b?q=80&w=1709&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        },
        {
            "id": 14,
            "songId": 1702257803,
            "userId": 4,
            "title": "紙羅蘭",
            "genre": "rap",
            "track": "https://akhls.streetvoice.com/music/te/d7/ted78247820/hyHUuzupTPoijPYiuFAg4x.mp3",
            "cover": "https://images.unsplash.com/photo-1532635241-17e820acc59f?q=80&w=2015&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        },
        {
            "id": 13,
            "songId": 1702257537,
            "userId": 4,
            "title": "Welcome to Christmas",
            "genre": "pop",
            "track": "https://akhls.streetvoice.com/music/sw/ee/sweetmachine/PEHEN4kkATEKsechmzzBbY.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1682681907111-c13bc10b1587?q=80&w=1888&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        },
        {
            "id": 11,
            "songId": 1702251853,
            "userId": 4,
            "title": "無精打采",
            "genre": "folk",
            "track": "https://akhls.streetvoice.com/music/ni/gh/nightkeepers2015/Zj3jkTATXygHWu6uxeiz5W.mp3",
            "cover": "https://images.unsplash.com/photo-1528642474498-1af0c17fd8c3?q=80&w=2069&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        },
        {
            "id": 5,
            "songId": 1702232225,
            "userId": 12,
            "title": "凌晨幾點",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/Di/nn/Dinner_Salute/gnpevBmk84iWXL99jqpPko.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1664879730345-ae3381805040?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 4567,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
    ]
}
```

#### 取得最新歌曲（曲風）

Response Example

```json
{
    "ok": 1,
    "count": 4,
    "songs": [
        {
            "id": 13,
            "songId": 1702257537,
            "userId": 4,
            "title": "Welcome to Christmas",
            "genre": "pop",
            "track": "https://akhls.streetvoice.com/music/sw/ee/sweetmachine/PEHEN4kkATEKsechmzzBbY.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1682681907111-c13bc10b1587?q=80&w=1888&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 0,
            "UserId": 4,
            "User": {
                "id": 4,
                "username": "alice0328",
                "nickname": "alice",
                "avatar": null
            }
        },
        {
            "id": 5,
            "songId": 1702232225,
            "userId": 12,
            "title": "凌晨幾點",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/Di/nn/Dinner_Salute/gnpevBmk84iWXL99jqpPko.mp3",
            "cover": "https://plus.unsplash.com/premium_photo-1664879730345-ae3381805040?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 4567,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        },
        {
            "id": 1,
            "songId": 1702232051,
            "userId": 10,
            "title": "日常守護者",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/an/ti/anti_talent/5X4BpATVcCWdC2HwuGQKFd.mp3",
            "cover": "https://akstatic.streetvoice.com/song_covers/an/ti/anti_talent/AMKZ8gbsh999itM8a9TXJ2.jpeg?x-oss-process=image/resize,m_fill,h_380,w_380,limit_0/interlace,1/quality,q_95/sharpen,80/format,jpg",
            "playCount": 6085,
            "UserId": 10,
            "User": {
                "id": 10,
                "username": "anti_talent",
                "nickname": "沒有才能",
                "avatar": "https://streetvoice.com/anti_talent/"
            }
        },
        {
            "id": 8,
            "songId": 1702232581,
            "userId": 12,
            "title": "你想要的 我給不起",
            "genre": "Pop",
            "track": "https://akhls.streetvoice.com/music/ro/be/roberthu0410/KWrDG8JK3rntwEbERTaJoz.mp3",
            "cover": "https://images.unsplash.com/photo-1517841905240-472988babdf9?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D",
            "playCount": 7681,
            "UserId": 12,
            "User": {
                "id": 12,
                "username": "ilovefunk_0407",
                "nickname": "郭子恆Jemmy",
                "avatar": "https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
            }
        }
    ]
}
```
