2.8 Playlists

GET /playlists

Retourne les listes de lectures de tous les utilisateurs.

Entrée

Token d'authentification nécessaire

Aucun paramètres

Sortie

Retourne une liste de playlists

[{
    "tracks": [],
    "owner": {
        "email": "name@mail.com",
        "name": "username",
        "id": "5678"
    },
    "id": "1234"
}, {
 ...
}]

GET /playlists/:id

Permet d'afficher la liste de lecture à l'id demandé.

Entrée

Token d'authentification nécessaire

Aucun paramètres

Sortie

Exemple:

{
    "tracks": [],
    "owner": {
        "email": "name@mail.com",
        "name": "username",
        "id": "5678"
    },
    "id": "1234"
}

POST /playlists

Permet de créer une nouvelle liste de lecture.

Entrée

Token d'authentification nécessaire

** Paramètres d'entrée **

owner est seulement nécessaire pour utilisation sans token

{
  "name": "Playlist name",
  "owner": "owner@mail.com" 
}

Sortie

Exemple:

{
    "name": "Playlist name",
    "tracks": [],
    "id": "12345"
}

PUT /playlists/:id

Permet de modifier la liste de lecture à l'id demandé.

Entrée

Token d'authentification nécessaire

** Paramètres d'entrée **

owner est seulement nécessaire pour utilisation sans token

{
  "name": "Playlist name",
  "owner": "owner@mail.com" 
}

Sortie

Exemple:

{
    "name": "Playlist name",
    "tracks": [],
    "id": "12345"
}

DELETE /playlists/:id

Permet de supprimer la liste de lecture à l'id demandé.

Entrée

Token d'authentification nécessaire

** Paramètres d'entrée ** AUCUN

Sortie

Exemple:

{
    "message": "Playlist ${PLAYLIST_ID} deleted successfully"
}

POST /playlists/:id/tracks

Permet d'ajouter une chanson la liste de lecture à l'id demandé.

Entrée

Token d'authentification nécessaire

** Paramètres d'entrée **

Correspond à un objet track.

{
    "wrapperType": "track",
    "kind": "song",
    "artistId": 116851,
    "collectionId": 325483,
    "trackId": 325479,
    "artistName": "Blink-182",
    "collectionName": "Enema of the State",
    "trackName": "Dumpweed",
    "collectionCensoredName": "Enema of the State",
    "trackCensoredName": "Dumpweed",
    "artistViewUrl": "https://itunes.apple.com/us/artist/blink-182/id116851?uo=4",
    "collectionViewUrl": "https://itunes.apple.com/us/album/dumpweed/id325483?i=325479&uo=4",
    "trackViewUrl": "https://itunes.apple.com/us/album/dumpweed/id325483?i=325479&uo=4",
    "previewUrl": "http://a816.phobos.apple.com/us/r1000/118/Music/e6/86/40/mzm.xhlwhbtm.aac.p.m4a",
    "artworkUrl30": "http://a1.mzstatic.com/us/r30/Features/cb/72/0e/dj.aoonomrr.30x30-50.jpg",
    "artworkUrl60": "http://a3.mzstatic.com/us/r30/Features/cb/72/0e/dj.aoonomrr.60x60-50.jpg",
    "artworkUrl100": "http://a2.mzstatic.com/us/r30/Features/cb/72/0e/dj.aoonomrr.100x100-75.jpg",
    "collectionPrice": 9.99,
    "trackPrice": 1.29,
    "releaseDate": "1999-05-25T07:00:00Z",
    "collectionExplicitness": "explicit",
    "trackExplicitness": "explicit",
    "discCount": 1,
    "discNumber": 1,
    "trackCount": 12,
    "trackNumber": 1,
    "trackTimeMillis": 143862,
    "country": "USA",
    "currency": "USD",
    "primaryGenreName": "Alternative",
    "contentAdvisoryRating": "Explicit",
    "radioStationUrl": "https://itunes.apple.com/station/idra.325479"
}

Sortie

Exemple:

La playlist contiendra la nouvelle chanson dans la liste tracks.

{
    "name": "Playlist name",
    "tracks": [],
    "id": "12345"
}

DELETE /playlists/:playlistId/tracks/:trackId

Permet de retirer la chanson avec l'id trackId de la liste de lecture à l'id playlistId demandé.

Entrée

Token d'authentification nécessaire

** Aucun paramètres **

Sortie

Exemple:

La playlist ne contient plus la chanson à l'id trackId dans la liste tracks.

{
    "name": "Playlist name",
    "tracks": [],
    "id": "12345"
}