carnet

Creer une playlist

Cree une playlist dans le carnet PRIVE de l'appelant. Les playlists sont PLATES et multi-appartenance : songIds est la liste ORDONNEE des chansons, et une meme chanson peut figurer dans plusieurs playlists.

L'ORDRE de songIds est celui que l'utilisateur verra : il est conserve tel quel, jamais retrie.

Un identifiant de songIds qui n'est pas une chanson vivante de l'appelant fait echouer l'appel ENTIER (404 indifferencie) : une playlist posee a moitie serait pire qu'un refus.

IDEMPOTENCE : poser Idempotency-Key evite un doublon apres un delai reseau (un rejeu exact rend le meme identifiant, en 200).

post/me/playlists

Request

  • Base URL: https://jam-jam.org/api/v1
  • URL: https://jam-jam.org/api/v1/me/playlists
  • Auth: one of:
    • HTTP bearer
    • none

Headers

Idempotency-Keystring

Request body

namestring required
coverEmojistring nullable
songIdsstring[]

Contenu ORDONNE. Chaque identifiant doit etre une chanson vivante de l'appelant, sinon l'appel entier rend 404 indifferencie.

Response

Rejeu idempotent d'une creation precedente

idstring required

Identifiant stable de l'objet ecrit.

updatedAtstring date-time required

Horodatage serveur apres l'ecriture, en ISO 8601 UTC au millieme. C'est EXACTEMENT la valeur a renvoyer dans If-Match.

publishedboolean

Present UNIQUEMENT quand la requete portait publish : etat REEL de la publication apres l'ecriture. Un refus de publication n'est jamais un published: false silencieux, c'est un 409.

Changes

No recorded changes to this operation across all 1 revision of this API.