track

trackfile

POST https://hiddentrack.link/track/trackfile

트렉파일을 첨부할 때 s3에 저장하고 url받기

Request Body

Name	Type	Description
soundTrack	object

201 성공

{ track_url : "www.s3.com/track01.mp3" }

401 권한없는 경우

trackimage

POST https://hiddentrack.link/track/trackimage

유저가 이미지 첨부트렉이미지 s3에 올리고 url 받기

Request Body

Name	Type	Description
img	object

201 성공

{ image_url : "www.s3.com/track01.mp3" }

401 권한없는 경우

track

POST https://hiddentrack.link/track

유저가 트랙을 등록할 떄 요청 (토큰으로 user.id 가져옴) /게시판자동생성 ,해쉬태그 추가)

Headers

Name	Type	Description
accesstoken	string

Request Body

Name	Type	Description
tag	array
title	string
img	string	img파일 url
genre	string
releaseAt	string
soundtrack	string	soun track파일 url
lyric	string

201 성공하면 트랙게시글으로 이동 이동해서 게시글 정보 요청하기

{ trackId : 1 }

400 입력값 이 부족한 경우

401 유저권한이 없는경우

trackfile

PATCH https://hiddentrack.link/track/trackfile

유저가 mp3파일 수정하면 기존에 있던것 지우고 새로운 것 s3에 올리고 url 받기

Request Body

Name	Type	Description
soundtrack	object

201 성공

{track_url : "wwww.s3.com/track001.jpg"}

401 유저 권한이 없는 경우 / 트렉에 대한 권한이 없는

trackimage

PATCH https://hiddentrack.link/track/trackimage

유저가 트랙이미지를 수정하면 기존에 있던 것 지우고 새로운 것 s3에 올리고 url 받기

Request Body

Name	Type	Description
img	string

201 성공

{ image_url : "wwww.s3.com/img01.jpg" }

401 유저권한이 없는 경우 /트렉에 대한권한이 없는 경우

track

PATCH https://hiddentrack.link/track

트렉 수정

Headers

Name	Type	Description
accesstoken	string

Request Body

Name	Type	Description
id	string
title	string
img	string
genre	string
releaseAt	string
soundtrack	string
lyric	string

200 성공

{ trackId : 1 }

400 입력값이 부족한 이유

401 track에 대한 권한이 없는 경우

track

DELETE https://hiddentrack.link/track

track 지우기 (관련된 post ,reply, 등 삭제)

Headers

Name	Type	Description
accesstoken	string

Request Body

Name	Type	Description
id	integer	track.id

200 성공

{message : "ok" }

401 track의 userId와 토큰의 userId 가 일치하지 않을 때

charts

GET https://hiddentrack.link/track/charts/all

메인페이지에서 인기차트,최신차트,추천차트에 대한 요청

200 성공

{
          latestchart: [{
           img :img,
           id :id
           title: title,
           user: {
            nickname: nickname
           }
           }],
          popularchart: [{
           img :img,
           id :id
           title: title,
           user: {
            nickname: nickname
           }
           }]
          recommendchart: [{
           img :img,
           id :id
           title: title,
           user: {
            nickname: nickname
           }
           }]
 }

search

GET https://hiddentrack.link/track/search

검색했을 때 요청

Path Parameters

Name	Type	Description
query	string

200 성공

{
    nickName: [{
           img :"img.jpg",
           id :1
           title: "title",
           user: {
            nickname: "nickname"
           }
     }],
    title: [{
           img :"img.jpg",
           id :1
           title: "title",
            user: {
            nickname: "nickname"
           }
    }],
    hashTag:[{
      tag:"tag"
    }
} 

400 작성예정

genre

GET https://hiddentrack.link/track/genre/:genre

장르를 눌렀을 때 요청

Path Parameters

Name	Type	Description
genre	string

200 성공

{
        track: [{
           id :id,
           img : img,
           title: title,
           user : {
             nickname: nickname
           }
         }]
 } 

400 genre가 없을 때

hashtag

GET https://hiddentrack.link/track/hashtag/:tag

hashtag를 눌렀을 때 요청

Path Parameters

Name	Type	Description
tag	string

200

{
        track: [{
           id :id,
           img : img,
           title: title,
           user : {
             nickname: nickname
           }
         }]
 } 

400 요청한 hashtag가 없을 때

track

GET https://hiddentrack.link/track/:trackId

Path Parameters

Name	Type	Description
trackId	integer

200 성공

{
        track: [{
          id: 1,
          title: "title",
          img: : "img01.jpg",
          genre: "genre",
          soundtrack : "soundtrack.mp3",
          releaseAt: "releaseAt",
          lyric :"lyric",
         
          user: {
           nickname: "nickname"
          }
          hashtags: [{
           tag: "tag1"
          },{
           tag: "tag2"
          }...]
          replies: [{
           id : 1,
           content: "content",
           user: {
             profile: "profile.jpg",
             nickname: "nickname"
            } 
          }...]
         }],
         like : 10,
        gradeAev : 4.3
} 

400 trackId가 안들어왔을 때

404 요청한 track이 없을 때

good

POST https://hiddentrack.link/track/good

유저가 좋아요를 눌렀을 때 요청(한번더 하면 취소)

Headers

Name	Type	Description
accesstoken	string

Request Body

Name	Type	Description
trackId	integer

200

{ likecount : 1 }

400 관련된 trackId가 없을 때

401 유저권한이 없을 때

grade

POST https://hiddentrack.link/track/grade

유저가 track에 대한 평점을 내렸을 때 요청

Headers

Name	Type	Description
accesstoken	string

Request Body

Name	Type	Description
trackId	integer
userGrade	integer

200 성공

{gradeAev : 3.5 }            

400 관련된trackId가 없을 때 // 평점이 없을 때

401 유저권한이 없을 때

409 이미 평가 했을 때