# 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"
}
}
]
}
```
Sign in with Wallet
Connect another wallet