metabrainz / web-service-v3-design

A collaborative specification for the third version of the MusicBrainz web service
2 stars 1 forks source link

JSON Pattern says Lists will contain at most one element ? #16

Closed ijabz closed 12 years ago

ijabz commented 12 years ago

JSON Patterns say All end points document a minimum complete response that documents the full schema you can expect back. These example responses are minimal in that the lists will contain at most 1 element.

I don't clearly understand what this means because when I look at the release endpoint it has element slike labels and mediums that can contain multiple values.

ocharles commented 12 years ago

This is documentation explaining what the JSON means in the web service documentation itself. When I wrote the JSON there, I wanted to express the entire structure of a document, so lists contain a single element which is the schema of all items in that list. The actual web service will contain multiple elements.