User:Nikki/ws/2

From MusicBrainz Wiki
< User:Nikki
Revision as of 14:54, 4 October 2014 by Nikki (talk | contribs) (add missing *-rels includes)
Jump to navigationJump to search

Attempting to decipher Development/XML_Web_Service/Version_2.

/ws/2/artist/MBID

recordings (limited to 25), releases (limited to 25), release-groups (limited to 25), works (limited to 25) tags, ratings, user-tags, user-ratings, annotation

- artist-rels
- label-rels
- recording-rels
- release-rels
- release-group-rels
- url-rels
- work-rels


/ws/2/release-group/MBID

inc parameters:

Parameter Description
artists The artist credit for this release group (limited to 25???)
releases A list of releases in this release group (limited to 25)
artist-credits The artist credit for the release group as well as artist credits for the releases in the release group when using inc=releases, for other entities when included via *-rels
aliases ???
annotation The annotation for this release group
ratings Ratings for this release group
tags Tags for this release group
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this release group and artists [1]
release-group-rels Relationships between this release group and other release groups [2]
release-rels Relationships between this release group and releases (currently none) [3]
recording-rels Relationships between this release group and recordings (currently none) [4]
work-rels Relationships between this release group and works (currently none) [5]
url-rels Relationships between this release group and URLs [6]
label-rels Relationships between this release group and labels (currently none) [7]
area-rels Relationships between this release group and areas [8]
place-rels Relationships between this release group and places [9]
series-rels Relationships between this release group and series [10]
instrument-rels Relationships between this release group and instruments [11]


/ws/2/release/MBID

artists (limited to 25), labels (limited to 25), recordings (limited to 25), release-groups (limited to 25) tags, user-tags annotation

- artist-rels
- label-rels
- recording-rels
- release-rels
- release-group-rels
- url-rels
- work-rels
- recording-level-rels
- work-level-rels


/ws/2/recording/MBID

inc parameters:

Parameter Description
releases Releases which use this recording (limited to 25).
artists The artist credit for this recording (limited to 25???)
artist-credits The artist credit for this recording as well as artist credits for the releases using the recording when using inc=releases, for other entities when included via *-rels
aliases If "artists" is used (doesn't work with "artist-credits"), includes aliases for the artists in the artist credit.
annotation The annotation for this recording
ratings Ratings for this recording
tags Tags for this recording
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this recording and artists [12]
release-group-rels Relationships between this recording and release groups (currently none) [13]
release-rels Relationships between this recording and releases (currently none) [14]
recording-rels Relationships between this recording and other recordings [15]
work-rels Relationships between this recording and works [16]
url-rels Relationships between this recording and URLs [17]
label-rels Relationships between this recording and labels [18]
area-rels Relationships between this recording and areas [19]
place-rels Relationships between this recording and places [20]
series-rels Relationships between this recording and series [21]
instrument-rels Relationships between this recording and instruments [22]


/ws/2/work/MBID

inc parameters:

Parameter Description
aliases Aliases for this work
annotation The annotation for this work
ratings Ratings for this work
tags Tags for this work
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this work and artists [23]
release-group-rels Relationships between this work and release groups (currently none) [24]
release-rels Relationships between this work and releases (currently none) [25]
recording-rels Relationships between this work and recordings [26]
work-rels Relationships between this work and other works [27]
url-rels Relationships between this work and URLs [28]
label-rels Relationships between this work and labels [29]
area-rels Relationships between this work and areas [30]
place-rels Relationships between this work and places [31]
series-rels Relationships between this work and series [32]
instrument-rels Relationships between this work and instruments [33]


/ws/2/label/MBID

inc parameters:

Parameter Description
releases A list of releases using this label (limited to 25, do what for more?)
artist-credits Artist credits for the releases using this label when using inc=releases, for other entities when included via *-rels
aliases Aliases for this label
ratings Ratings for this label
tags Tags for this label
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this label and artists [34]
release-group-rels Relationships between this label and release groups (currently none) [35]
release-rels Relationships between this label and releases [36]
recording-rels Relationships between this label and recordings [37]
work-rels Relationships between this label and works [38]
url-rels Relationships between this label and URLs [39]
label-rels Relationships between this label and other labels [40]
area-rels Relationships between this label and areas [41]
place-rels Relationships between this label and places [42]
series-rels Relationships between this label and series [43]
instrument-rels Relationships between this label and instruments [44]

/ws/2/area/MBID

inc parameters:

Parameter Description
aliases Aliases for this area
annotation The annotation for this area
ratings ???
tags ???
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this area and artists (currently none) [45]
release-group-rels Relationships between this area and release groups (currently none) [46]
release-rels Relationships between this area and releases [47]
recording-rels Relationships between this area and recordings [48]
work-rels Relationships between this area and works [49]
url-rels Relationships between this area and URLs [50]
label-rels Relationships between this area and labels (currently none) [51]
area-rels Relationships between this area and other areas [52]
place-rels Relationships between this area and places [53]
series-rels Relationships between this area and series [54]
instrument-rels Relationships between this area and instruments [55]

/ws/2/place/MBID

inc parameters:

Parameter Description
aliases Aliases for this place
annotation The annotation for this place
ratings ???
tags ???
user-tags ??? (auth required)
user-ratings ??? (auth required)
artist-rels Relationships between this place and artists [56]
release-group-rels Relationships between this place and release groups [57]
release-rels Relationships between this place and releases [58]
recording-rels Relationships between this place and recordings [59]
work-rels Relationships between this place and works [60]
url-rels Relationships between this place and URLs [61]
label-rels Relationships between this place and labels (currently none) [62]
area-rels Relationships between this place and areas [63]
place-rels Relationships between this place and other places [64]
series-rels Relationships between this place and series [65]
instrument-rels Relationships between this place and instruments [66]

/ws/2/series/MBID

inc parameters:

Parameter Description
aliases Aliases for this series
annotation The annotation for this series
artist-rels Relationships between this series and artists [67]
release-group-rels Relationships between this series and release groups [68]
release-rels Relationships between this series and releases [69]
recording-rels Relationships between this series and recordings [70]
work-rels Relationships between this series and works [71]
url-rels Relationships between this series and URLs [72]
label-rels Relationships between this series and labels (currently none) [73]
area-rels Relationships between this series and areas [74]
place-rels Relationships between this series and places [75]
series-rels Relationships between this series and other series [76]
instrument-rels Relationships between this series and instruments [77]

/ws/2/instrument/MBID

inc parameters:

Parameter Description
aliases Aliases for this instrument
annotation The annotation for this instrument
artist-rels Relationships between this instrument and artists (currently none) [78]
release-group-rels Relationships between this instrument and release groups (currently none) [79]
release-rels Relationships between this instrument and releases (currently none) [80]
recording-rels Relationships between this instrument and recordings (currently none) [81]
work-rels Relationships between this instrument and works (currently none) [82]
url-rels Relationships between this instrument and URLs [83]
label-rels Relationships between this instrument and labels (currently none) [84]
area-rels Relationships between this instrument and areas [85]
place-rels Relationships between this instrument and places [86]
series-rels Relationships between this instrument and series [87]
instrument-rels Relationships between this instrument and other instruments [88]

/ws/2/url

inc parameters:

Parameter Description
resource Required. The exact URL to look up
artist-rels Relationships between this URL and artists [89]
release-group-rels Relationships between this URL and release groups (currently none) [90]
release-rels Relationships between this URL and releases [91]
recording-rels Relationships between this URL and recordings [92]
work-rels Relationships between this URL and works [93]
url-rels Relationships between this URL and other URLs [94] (currently none)
label-rels Relationships between this URL and labels [95]
area-rels Relationships between this URL and areas [96]
place-rels Relationships between this URL and places [97]
series-rels Relationships between this URL and series [98]
instrument-rels Relationships between this URL and instruments [99]

/ws/2/discid/DISCID

returns a list of releases inc = same as release toc = toc cdstub=no (optional, to turn off cd stubs)


/ws/2/puid/PUID

returns a list of recordings inc = same as recording

/ws/2/isrc/ISRC

returns a list of recordings inc = same as recording

/ws/2/iswc/ISWC

returns a list of works inc = same as recording