Talk:MusicBrainz API/XML: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(document non-supported use-cases)
 
Line 1: Line 1:
==Non-supported use-cases==
==Non-supported use-cases==
* "labels" isn't a valid inc parameter for release-group requests if "releases" is specified. This would be useful if we wanted to quickly compile a basic list of identifying info about all of the releases in a release group. e.g. having a list of "other versions" of a release in Picard that the user can switch to. With the current web service we can make a list of "Date - Country - Barcode - Format," but can't include the label or catalog number (which can be just as important) without making n additional requests for each release in the RG. --[[User:Bitmap|Bitmap]] 15:47, 21 May 2011 (UTC)
* "labels" isn't a valid inc parameter for release-group requests if "releases" is specified. This would be useful if we wanted to quickly compile a basic list of identifying info about all of the releases in a release group. e.g. having a list of "other versions" of a release in Picard that the user can switch to. With the current web service we can make a list of "Date - Country - Barcode - Format," but can't include the label or catalog number (which can be just as important) without making n additional requests for each release in the RG. --[[User:Bitmap|Bitmap]] 15:47, 21 May 2011 (UTC)

== UNDOCUMENTED: <QUERY> seems to actually need double quotes surrounding ==

A query such as:

<pre>http://www.musicbrainz.org/ws/2/recording/?query=Moi+je+dors+pr%C3%A8s+de+la+Seine&artist=29c181c9-9069-41ec-a91d-82f50c7cd2a9</pre>

or

<pre>http://www.musicbrainz.org/ws/2/recording/?query=Moi+je+dors+pr%C3%A8s+de+la+Seine&arid:29c181c9-9069-41ec-a91d-82f50c7cd2a9</pre>

will not actually recognize the &artist= or &arid= or &arid: parameter unless the query portion is wrapped in double quotes like:

<pre>http://www.musicbrainz.org/ws/2/recording/?query="Moi+je+dors+pr%C3%A8s+de+la+Seine"&artist=29c181c9-9069-41ec-a91d-82f50c7cd2a9</pre>

Need to have more detailing in the docs about HOW the <QUERY> should be wrapped properly in order for additional parameters after it to be properly recognized.
(or else you could classify this as a bug and say that it SHOULD NOT NEED double quotes ? dunno)

Revision as of 22:57, 31 January 2012

Non-supported use-cases

  • "labels" isn't a valid inc parameter for release-group requests if "releases" is specified. This would be useful if we wanted to quickly compile a basic list of identifying info about all of the releases in a release group. e.g. having a list of "other versions" of a release in Picard that the user can switch to. With the current web service we can make a list of "Date - Country - Barcode - Format," but can't include the label or catalog number (which can be just as important) without making n additional requests for each release in the RG. --Bitmap 15:47, 21 May 2011 (UTC)

UNDOCUMENTED: <QUERY> seems to actually need double quotes surrounding

A query such as:

http://www.musicbrainz.org/ws/2/recording/?query=Moi+je+dors+pr%C3%A8s+de+la+Seine&artist=29c181c9-9069-41ec-a91d-82f50c7cd2a9

or

http://www.musicbrainz.org/ws/2/recording/?query=Moi+je+dors+pr%C3%A8s+de+la+Seine&arid:29c181c9-9069-41ec-a91d-82f50c7cd2a9

will not actually recognize the &artist= or &arid= or &arid: parameter unless the query portion is wrapped in double quotes like:

http://www.musicbrainz.org/ws/2/recording/?query="Moi+je+dors+pr%C3%A8s+de+la+Seine"&artist=29c181c9-9069-41ec-a91d-82f50c7cd2a9

Need to have more detailing in the docs about HOW the <QUERY> should be wrapped properly in order for additional parameters after it to be properly recognized. (or else you could classify this as a bug and say that it SHOULD NOT NEED double quotes ? dunno)