Komma_Project

Login

POST http://www.kommaa.shop/users/login

Client 로그인 요청.

Request Body

Name	Type	Description
email	string	User email Value
password	string	User password Value

200 Login Success

{ 
  "accessToken": accessToken, 
  "message": "Login successfully"
}

400 Hassing err

{ "message": "hashPwd exists" }

401 User Not Found

{ "message": "not authorized"}

Logout

POST http://www.kommaa.shop/users/logout

Client 로그아웃 요청.

Headers

Name	Type	Description
Content-Type	string	application/json
withCredentials	string	true

205 Success message

{ "message": "Logout successfully" }

signup

POST http://www.kommaa.shop/users/signup

Client 유저 회원 가입 요청.

Request Body

Name	Type	Description
email	string	User username value
username	string	User email value
password	string	User password value

201 SignUp Success.

{ "message": "Sign successfully" }

409 email 중복.

{ "message": "email exists"}

422 Parameter check.

{ "message": "insufficient parameters supplied" }

UserInfo

GET http://www.kommaa.shop/users/userinfo

Client 로그인 후 생성 된 AccessToken으로 유저 정보 요청

Headers

Name	Type	Description
Authorization	string	`Bearer ${token}`
withCredentials	string	true

200

{
    "userInfo": {
        "id": 22,
        "email": "[e-mail]",
        "username": "배석재",
        "darkmode": false,
        "sitecolor": "teal"
    },
    "playlists": [
        {
            "id": 7,
            "title": "배석재꺼1",
            "icon": "https://i.imgur.com/nHbNWeR.png",
            "play": false,
            "savesongs": [
                {
                    "savesongId": 11,
                    "id": 3,
                    "iconImg": "https://i.imgur.com/gnBFt6F.png",
                    "title": "도마",
                    "soundFile": "http://www.kommaa.shop/sounds/cooking.mp3",
                    "defaultVolume": 0,
                    "play": true
                },
                {
                    "savesongId": 12,
                    "id": 5,
                    "iconImg": "https://i.imgur.com/WyPSnld.png",
                    "title": "보글보글",
                    "soundFile": "http://www.kommaa.shop/sounds/bubble.mp3",
                    "defaultVolume": 0,
                    "play": true
                }
            ]
        },
        {
            "id": 8,
            "title": "배석재꺼2",
            "icon": "https://i.imgur.com/E2u4I6X.png",
            "play": false,
            "savesongs": [
                {
                    "savesongId": 13,
                    "id": 3,
                    "iconImg": "https://i.imgur.com/gnBFt6F.png",
                    "title": "도마",
                    "soundFile": "http://www.kommaa.shop/sounds/cooking.mp3",
                    "defaultVolume": 0,
                    "play": true
                },
                {
                    "savesongId": 14,
                    "id": 5,
                    "iconImg": "https://i.imgur.com/WyPSnld.png",
                    "title": "보글보글",
                    "soundFile": "http://www.kommaa.shop/sounds/bubble.mp3",
                    "defaultVolume": 0,
                    "play": true
                }
            ]
        }
    ]
}

400 Invaild AccessToken

{ "message": "AccessToken not authorized" }

UserInfoUp

POST http://www.kommaa.shop/users/userinfoup

Client username, password 변경.

Headers

Name	Type	Description
Authorization	string	`Bearer ${token}`
withCredentials	string	true

Request Body

Name	Type	Description
username	string	Changed username (변경한 유저 닉네임)
passwrod	string	Changed password (변경한 비밀 번호)
darkmode	string	Changed darmode state (다크모드 사용 유무)
sitecolor	string	Changed sitecolor (변경한 사이트 컬)

302 data의 value값에 변경된 값이 들어가게 됩니다.

{ "data": "홍길동" }

401 AccessToken이 없을때 생기는 오류입니다.

{ "message": "not authorized" }

SongList

GET http://www.kommaa.shop/playlist/songlist

Client 사이트의 전체 음원 리스트

Path Parameters

Name	Type	Description
Content-Type	string	application/json

200 value는 배열로 각 song에 대한 정보가 각각 object로 들어가있습니다.

{ "songlist": [
            {
              id: "1",
              title: "물",
              iconimg: "https://i.imgur.com/U89ed7j.jpg",
              soundFile: "http://kommaa.shop/sounds/water.mp3",
              defaultVolume: 0.4,
              play: false
            },
            {
              id: "2"
              title: "바람"
              iconimg: "https://i.imgur.com/U89ed7j.jpg",
              soundFile: "http://kommaa.shop/sounds/wind.mp3",
              defaultVolume: 0.4,
              play: false
            },
            {
              id: "3"
              title: ""
              iconimg: "https://i.imgur.com/U89ed7j.jpg",
              soundFile: "http://kommaa.shop/sounds/fire.mp3",
              defaultVolume: 0.4,
              play: false
            },
            ...
          ]
}

SavePlayList

POST http://www.kommaa.shop/playlist/saveplaylist

Client 유저 playlist 저장

Headers

Name	Type	Description
Authorization	string	`Bearer ${token}`
withCredentials	string	true

Request Body

Name	Type	Description
title	string	Users input value (title)
icon	string	Users select icon (Img)
savesongs	string	Users select song list (Array & Object)

200 Success message

{ "message": "Save playlist Successfully }

401 AccessToken이 없을때 생기는 오류.

{ "message": "not authorized" }

DeletePlayList

POST http://www.kommaa.shop/playlist/deleteplaylist

Client 플레이 리스트 삭제 / id = playlist의 고유 id

Headers

Name	Type	Description
Authorization	string	`Bearer ${token}`

Request Body

Name	Type	Description
id	string	playlist id value

200 SuccessedD

{ "message": "Delete playlist Successfully"}

401 AccessToken이 없을때 생기는 오류입니다.

{ "message": "not authorized" }

UpdatePlayList

POST http://www.kommaa.shop/playlist/updateplaylist

Client 플레이 리스트 타이틀 변경 / id = playlist의 고유 id

Headers

Name	Type	Description
Authorization	string	`Bearer ${token}`

Request Body

Name	Type	Description
id	string	playlist id value

302

{ "message": "update successfully" }

400

{ "data": null, "message": "invalid access token" }