User:Nikki/ws/2: Difference between revisions
From MusicBrainz Wiki
Jump to navigationJump to search
mNo edit summary |
mNo edit summary |
||
Line 1: | Line 1: | ||
Attempting to decipher [[Development/XML_Web_Service/Version_2]]. |
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 |
|||
- artist-rels |
|||
- label-rels |
|||
- recording-rels |
|||
- release-rels |
|||
- release-group-rels |
|||
- url-rels |
|||
- work-rels |
|||
== /ws/2/release-group/MBID == |
== /ws/2/release-group/MBID == |
||
Line 6: | Line 18: | ||
! Parameter !! Description |
! Parameter !! Description |
||
|- |
|- |
||
| artists || The artist credit for this release group |
| <tt>artists</tt> || The artist credit for this release group (limited to 25???) |
||
|- |
|- |
||
| releases || A list of releases in this release group (limited |
| <tt>releases</tt> || 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 |
| 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 |
||
Line 14: | Line 26: | ||
| aliases || ??? |
| aliases || ??? |
||
|- |
|- |
||
| ratings || Ratings for this release group |
| <tt>ratings</tt> || Ratings for this release group |
||
|- |
|- |
||
| tags || Tags for this release group |
| <tt>tags</tt> || Tags for this release group |
||
|- |
|- |
||
| user-tags || ??? (auth required) |
| <tt>user-tags</tt> || ??? (auth required) |
||
|- |
|- |
||
| user-ratings || ??? (auth required) |
| <tt>user-ratings</tt> || ??? (auth required) |
||
|- |
|- |
||
| artist-rels || Relationships between this release group and artists [https://musicbrainz.org/relationships/artist-release_group] |
| <tt>artist-rels</tt> || Relationships between this release group and artists [https://musicbrainz.org/relationships/artist-release_group] |
||
|- |
|- |
||
| release-group-rels || Relationships between this release group and other release groups [https://musicbrainz.org/relationships/release_group-release_group] |
| <tt>release-group-rels</tt> || Relationships between this release group and other release groups [https://musicbrainz.org/relationships/release_group-release_group] |
||
|- |
|- |
||
| release-rels || Relationships between this release group and releases (currently none) [https://musicbrainz.org/relationships/release-release_group] |
| <tt>release-rels</tt> || Relationships between this release group and releases (currently none) [https://musicbrainz.org/relationships/release-release_group] |
||
|- |
|- |
||
| recording-rels || Relationships between this release group and recordings (currently none) [https://musicbrainz.org/relationships/recording-release_group] |
| <tt>recording-rels</tt> || Relationships between this release group and recordings (currently none) [https://musicbrainz.org/relationships/recording-release_group] |
||
|- |
|- |
||
| work-rels || Relationships between this release group and works (currently none) [https://musicbrainz.org/relationships/release_group-work] |
| <tt>work-rels</tt> || Relationships between this release group and works (currently none) [https://musicbrainz.org/relationships/release_group-work] |
||
|- |
|- |
||
| url-rels || Relationships between this release group and URLs [https://musicbrainz.org/relationships/release_group-url] |
| <tt>url-rels</tt> || Relationships between this release group and URLs [https://musicbrainz.org/relationships/release_group-url] |
||
|- |
|- |
||
| label-rels || Relationships between this release group and labels (currently none) [https://musicbrainz.org/relationships/label-release_group] |
| <tt>label-rels</tt> || Relationships between this release group and labels (currently none) [https://musicbrainz.org/relationships/label-release_group] |
||
|} |
|} |
||
== /ws/2/release/MBID == |
|||
artists (limited to 25), labels (limited to 25), recordings (limited to 25), release-groups (limited to 25) |
|||
tags, user-tags |
|||
- 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 == |
== /ws/2/recording/MBID == |
||
Line 42: | Line 69: | ||
! Parameter !! Description |
! Parameter !! Description |
||
|- |
|- |
||
| |
| <tt>releases</tt> || Releases which use this recording (limited to 25). |
||
|- |
|||
| <tt>artists</tt> || 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 |
| 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 |
||
Line 48: | Line 77: | ||
| aliases || If "artists" is used (doesn't work with "artist-credits"), includes aliases for the artists in the artist credit. |
| aliases || If "artists" is used (doesn't work with "artist-credits"), includes aliases for the artists in the artist credit. |
||
|- |
|- |
||
| ratings || Ratings for this recording |
| <tt>ratings</tt> || Ratings for this recording |
||
|- |
|- |
||
| tags || Tags for this recording |
| <tt>tags</tt> || Tags for this recording |
||
|- |
|- |
||
| user-tags || ??? (auth required) |
| <tt>user-tags</tt> || ??? (auth required) |
||
|- |
|- |
||
| user-ratings || ??? (auth required) |
| <tt>user-ratings</tt> || ??? (auth required) |
||
|- |
|- |
||
| artist-rels || Relationships between this recording and artists [https://musicbrainz.org/relationships/artist-recording] |
| <tt>artist-rels</tt> || Relationships between this recording and artists [https://musicbrainz.org/relationships/artist-recording] |
||
|- |
|- |
||
| release-group-rels || Relationships between this recording and release groups (currently none) [https://musicbrainz.org/relationships/recording-release_group] |
| <tt>release-group-rels</tt> || Relationships between this recording and release groups (currently none) [https://musicbrainz.org/relationships/recording-release_group] |
||
|- |
|- |
||
| release-rels || Relationships between this recording and releases (currently none) [https://musicbrainz.org/relationships/recording-release] |
| <tt>release-rels</tt> || Relationships between this recording and releases (currently none) [https://musicbrainz.org/relationships/recording-release] |
||
|- |
|- |
||
| recording-rels || Relationships between this recording and other recordings [https://musicbrainz.org/relationships/recording-recording] |
| <tt>recording-rels</tt> || Relationships between this recording and other recordings [https://musicbrainz.org/relationships/recording-recording] |
||
|- |
|- |
||
| work-rels || Relationships between this recording and works [https://musicbrainz.org/relationships/recording-work] |
| <tt>work-rels</tt> || Relationships between this recording and works [https://musicbrainz.org/relationships/recording-work] |
||
|- |
|- |
||
| url-rels || Relationships between this recording and URLs [https://musicbrainz.org/relationships/recording-url] |
| <tt>url-rels</tt> || Relationships between this recording and URLs [https://musicbrainz.org/relationships/recording-url] |
||
|- |
|- |
||
| label-rels || Relationships between this recording and labels [https://musicbrainz.org/relationships/label-recording] |
| <tt>label-rels</tt> || Relationships between this recording and labels [https://musicbrainz.org/relationships/label-recording] |
||
|} |
|} |
||
Line 79: | Line 108: | ||
| aliases || Aliases for this work |
| aliases || Aliases for this work |
||
|- |
|- |
||
| ratings || Ratings for this work |
| <tt>ratings</tt> || Ratings for this work |
||
|- |
|- |
||
| tags || Tags for this work |
| <tt>tags</tt> || Tags for this work |
||
|- |
|- |
||
| user-tags || ??? (auth required) |
| <tt>user-tags</tt> || ??? (auth required) |
||
|- |
|- |
||
| user-ratings || ??? (auth required) |
| <tt>user-ratings</tt> || ??? (auth required) |
||
|- |
|- |
||
| artist-rels || Relationships between this work and artists [https://musicbrainz.org/relationships/artist-work] |
| <tt>artist-rels</tt> || Relationships between this work and artists [https://musicbrainz.org/relationships/artist-work] |
||
|- |
|- |
||
| release-group-rels || Relationships between this work and release groups (currently none) [https://musicbrainz.org/relationships/release_group-work] |
| <tt>release-group-rels</tt> || Relationships between this work and release groups (currently none) [https://musicbrainz.org/relationships/release_group-work] |
||
|- |
|- |
||
| release-rels || Relationships between this work and releases (currently none) [https://musicbrainz.org/relationships/release-work] |
| <tt>release-rels</tt> || Relationships between this work and releases (currently none) [https://musicbrainz.org/relationships/release-work] |
||
|- |
|- |
||
| recording-rels || Relationships between this work and recordings [https://musicbrainz.org/relationships/recording-work] |
| <tt>recording-rels</tt> || Relationships between this work and recordings [https://musicbrainz.org/relationships/recording-work] |
||
|- |
|- |
||
| work-rels || Relationships between this work and other works [https://musicbrainz.org/relationships/work-work] |
| <tt>work-rels</tt> || Relationships between this work and other works [https://musicbrainz.org/relationships/work-work] |
||
|- |
|- |
||
| url-rels || Relationships between this work and URLs [https://musicbrainz.org/relationships/url-work] |
| <tt>url-rels</tt> || Relationships between this work and URLs [https://musicbrainz.org/relationships/url-work] |
||
|- |
|- |
||
| label-rels || Relationships between this work and labels [https://musicbrainz.org/relationships/label-work] |
| <tt>label-rels</tt> || Relationships between this work and labels [https://musicbrainz.org/relationships/label-work] |
||
|} |
|} |
||
Line 108: | Line 137: | ||
! Parameter !! Description |
! Parameter !! Description |
||
|- |
|- |
||
| releases || A list of releases using this label (limited to 25, do what for more?) |
| <tt>releases</tt> || 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 |
| artist-credits || Artist credits for the releases using this label when using inc=releases, for other entities when included via *-rels |
||
Line 114: | Line 143: | ||
| aliases || Aliases for this label |
| aliases || Aliases for this label |
||
|- |
|- |
||
| ratings || Ratings for this label |
| <tt>ratings</tt> || Ratings for this label |
||
|- |
|- |
||
| tags || Tags for this label |
| <tt>tags</tt> || Tags for this label |
||
|- |
|- |
||
| user-tags || ??? (auth required) |
| <tt>user-tags</tt> || ??? (auth required) |
||
|- |
|- |
||
| user-ratings || ??? (auth required) |
| <tt>user-ratings</tt> || ??? (auth required) |
||
|- |
|- |
||
| artist-rels || Relationships between this label and artists [https://musicbrainz.org/relationships/artist-label] |
| <tt>artist-rels</tt> || Relationships between this label and artists [https://musicbrainz.org/relationships/artist-label] |
||
|- |
|- |
||
| release-group-rels || Relationships between this label and release groups (currently none) [https://musicbrainz.org/relationships/label-release_group] |
| <tt>release-group-rels</tt> || Relationships between this label and release groups (currently none) [https://musicbrainz.org/relationships/label-release_group] |
||
|- |
|- |
||
| release-rels || Relationships between this label and releases [https://musicbrainz.org/relationships/label-release] |
| <tt>release-rels</tt> || Relationships between this label and releases [https://musicbrainz.org/relationships/label-release] |
||
|- |
|- |
||
| recording-rels || Relationships between this label and recordings [https://musicbrainz.org/relationships/label-recording] |
| <tt>recording-rels</tt> || Relationships between this label and recordings [https://musicbrainz.org/relationships/label-recording] |
||
|- |
|- |
||
| work-rels || Relationships between this label and works [https://musicbrainz.org/relationships/label-work] |
| <tt>work-rels</tt> || Relationships between this label and works [https://musicbrainz.org/relationships/label-work] |
||
|- |
|- |
||
| url-rels || Relationships between this label and URLs [https://musicbrainz.org/relationships/label-url] |
| <tt>url-rels</tt> || Relationships between this label and URLs [https://musicbrainz.org/relationships/label-url] |
||
|- |
|- |
||
| label-rels || Relationships between this label and other labels [https://musicbrainz.org/relationships/label-label] |
| <tt>label-rels</tt> || Relationships between this label and other labels [https://musicbrainz.org/relationships/label-label] |
||
|} |
|} |
||
== /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 |
Revision as of 19:13, 12 December 2012
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
- 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 | ??? |
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] |
/ws/2/release/MBID
artists (limited to 25), labels (limited to 25), recordings (limited to 25), release-groups (limited to 25) tags, user-tags
- 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. |
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 [8] |
release-group-rels | Relationships between this recording and release groups (currently none) [9] |
release-rels | Relationships between this recording and releases (currently none) [10] |
recording-rels | Relationships between this recording and other recordings [11] |
work-rels | Relationships between this recording and works [12] |
url-rels | Relationships between this recording and URLs [13] |
label-rels | Relationships between this recording and labels [14] |
/ws/2/work/MBID
inc parameters:
Parameter | Description |
---|---|
aliases | Aliases 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 [15] |
release-group-rels | Relationships between this work and release groups (currently none) [16] |
release-rels | Relationships between this work and releases (currently none) [17] |
recording-rels | Relationships between this work and recordings [18] |
work-rels | Relationships between this work and other works [19] |
url-rels | Relationships between this work and URLs [20] |
label-rels | Relationships between this work and labels [21] |
/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 [22] |
release-group-rels | Relationships between this label and release groups (currently none) [23] |
release-rels | Relationships between this label and releases [24] |
recording-rels | Relationships between this label and recordings [25] |
work-rels | Relationships between this label and works [26] |
url-rels | Relationships between this label and URLs [27] |
label-rels | Relationships between this label and other labels [28] |
/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