Get all the audio artists


List all the audio artists from the user's music collection.

Endpoint URL: {network.internalDNSName or network.proxyURL} received in DeviceInformation

Request Syntax

GET /v1/audioArtists


Request Headers

ParameterDescriptionRequired
Accept-EncodingUse value gzip in Accept-Encoding header to compress the response data. This reduces network traffic and improves response time.

Value of type: string
false
AuthorizationAn access token with nas_read_only or nas_read_write scope as well as the File Permission with value ReadFile or FileOwner for the file or a parent.

Value of type: string
true
If-MatchA previous response ETag or *. Return the object only if its entity tag (ETag) is the same as the one specified.

Value of type: string
false
If-None-MatchA previous response ETag or *. Return the object only if its entity tag (ETag) is different from the one specified.

Value of type: string
false


Request Query Parameters

ParameterDescriptionRequired
fieldsThe fields to return.

Value of type: csv

Default: All fields
false
limitThe page size limit.

Value of type: integer

Default: 20
false
pageTokenThe pageToken obtained from the last response.

Value of type: string
false
prettyWhether to pretty print the response. It refers to the process of displaying source code or other items in a presentable way.

Value of type: boolean

Default: false
false


200 Response

OK

Response Headers

ParameterDescriptionRequired
Content-TypeIndicates the media type for the message body. The value will be application/json.false
EtagThe ETag for the response. It is used to determine the change in file metadata and content.false


Response Payload

ParameterDescriptionRequired
AudioArtistsAn array of audio artists.

Array of type: AudioArtist
true
pageTokenThe pageToken for the next request.

Value of type: string
false


Example

Sample request to list all the audio artists from the user's music collection.

Request

GET /sdk/v1/audioArtists?pretty=true&limit=3 HTTP/1.1Host: Endpoint-URLAuthorization: Bearer 8fc0180d-7ccc-4072-b923-93643201cf9e

Response

HTTP/1.1 200 OKContent-Type: application/jsonEtag: "nbt83IkgefJTl-JOWIBYbQ"Vary: OriginDate: Fri, 09 Sep 2016 23:42:59 GMTContent-Length: 324{  "audioArtists": [    {      "name": "2 Unlimited",    },    {      "name": "alanis morissette",    },    {      "name": "Albert Hammond",    }  ],  "pageToken": "QWxiZXJ0IEhhbW1vbmQ"}