carnet

Liste les chansons de mon carnet

Instantane pagine du carnet PRIVE de l'appelant, par curseur opaque (keyset, jamais d'offset), trie par updatedAt croissant. Les chansons supprimees ne sont pas rendues.

fields=summary (defaut) rend les metadonnees ; fields=full y ajoute song, le payload pivot canonique, exactement le meme objet que songs[0] de l'artefact GET /jobs/{id}/result/songbook.

EXPORT INCREMENTAL : garder le plus grand updatedAt recu et le repasser en updatedSince au prochain passage. Le filtre est STRICT (updatedAt > updatedSince).

Consomme une unite du compteur de LECTURE (read dans GET /me/usage), jamais une conversion.

get/me/songs

Request

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

Query parameters

cursorstring

Curseur OPAQUE rendu par nextCursor. A rejouer tel quel ; sa forme n'est pas un contrat et peut changer. Un curseur illisible rend 400 bad-request, jamais une page silencieusement fausse.

limitinteger

Taille de page. Defaut 30, plafond dur 100 (25 si fields=full).

updatedSincestring date-time

Date ISO 8601. Ne rend que les objets STRICTEMENT plus recents (updatedAt > updatedSince), pour un export incremental.

fields'summary' | 'full'

full joint le payload pivot complet. Le plafond de page tombe alors a 25 (un payload pivot pese des dizaines de kilo-octets).

Response

Page de chansons

nextCursorstring nullable required

A rejouer en cursor pour la page suivante ; null sur la derniere page.

Changes

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