tento.web.music — tento의 음악 관련 API

tento.web.music.create()

음악 데이터를 받아서 tento.music.Artist, tento.music.Album, tento.music.Music 을 생성합니다.

POST /musics/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: tento.com

{
  "music_name": "유감",
  "music_track_number": 1,
  "music_disc_number": 1,
  "artist_name": "leeSA",
  "album_name": "유감",
  "album_release_year": 2010,
  "genre": "팝 > 팝, 팝 > 발라드"
}

HTTP/1.1 201 created
Content-Type: application/json
Returns:생성된 tento.music.Artist , tento.music.Album , tento.music.Music 를 json으로 반환.
Statuscode 201:데이터가 정상적으로 생성됬음.
Statuscode 400:필요한 데이터가 비어있음.
Statuscode 500:서버 에러발생
tento.web.music.create_chunks()

여러 음악 데이터를 받아서 tento.music.Artist, tento.music.Album, tento.music.Music 을 생성합니다.

POST /musics/chunk/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: tento.com

{
    'musics': [
        {
            "music_name": "유감",
            "music_track_number": 1,
            "music_disc_number": 1,
            "artist_name": "leeSA",
            "album_name": "유감",
            "album_release_year": 2010,
            "genre": "팝 > 팝, 팝 > 발라드"
        },
        ...
    ]
}

HTTP/1.1 201 created
Content-Type: application/json

{
    'musics': [
        {'id': 1, 'name': '유감'},
        ...
    ]
}
Returns:생성된 tento.music.Artist , tento.music.Album , tento.music.Music 를 json으로 반환.
Statuscode 201:데이터가 정상적으로 생성됬음.
Statuscode 400:필요한 데이터가 비어있음.
Statuscode 500:서버 에러발생
tento.web.music.find_all_positions()

모든 :class:`tento.music.Position`을 조회합니다.

GET /musics/positions/?music_ids=1,2,3,4
Accept: application/json
Host: tento.com

HTTP/1.1 201 created
Content-Type: application/json
{
    "positions": [
        {
            "x": 0,
            "y": 0,
            "music_id": 1
        },
        ...
    ]
}
Query string music_ids:
 tento.music.Music.id 를 , 로 이어 붙인것.
Returns:조회한 :py:class:`tento.music.Position`을 json으로 반환
Statuscode 200:데이터가 정상적으로 조회되었음.
Statuscode 400:쿼리스트링에 이상한 문자열이 들어왔을때, music_ids가 없을때
Statuscode 500:서버 에러 발생.
tento.web.music.find_position(id_)
Parameters:id – 에 해당하는 :class:`tento.music.Position`을 조회합니다. 
GET /musics/:id/position/
Accept: application/json
Host: tento.com

HTTP/1.1 201 created
Content-Type: application/json

{
    "x": 0,
    "y": 0,
    "music_id": :id
}
Parameters:

id – tento.music.Music 의 tento.music.Music.id
Returns:

조회한 :py:class:`tento.music.Position`을 json으로 반환
Statuscode 200:

데이터가 정상적으로 조회되었음.
Statuscode 404:
param id_:에 해당하는 tento.music.Position

데이터가 존재하지않음.
Statuscode 500:

서버 에러 발생.
tento.web.music.position(id_)

음악 데이터를 받아서 :class:`tento.music.Position`을 생성합니다.

POST /musics/:id/position/
Content-Type: application/json
Accept: application/json
Host: tento.com

{
    "x": 10,
    "y": 9,
    "music_id": 1
}
..sourcecode:: http
HTTP/1.1 201 created Content-Type: application/json
Parameters:id – tento.music.Music 의 tento.music.Music.id
Returns:생성된 :py:class:`tento.music.Position`을 json으로 반환
Statuscode 201:데이터가 정상적으로 생성되었음.
Statuscode 400:필요한 데이터가 비어있음.
Statuscode 500:서버 에러 발생.