music nerd

Artist imagesPhoto choices

Artist images

Photo choices

The provider photos an artist can pick as their profile photo: one option each for Deezer and Spotify, from the IDs linked on the artist. expectedCustomImage is the current photo; pass it to Choose a provider photo so a stale choice is refused.

GET/api/artist/photo-choice
GET/api/artist/photo-choice

The provider photos an artist can pick as their profile photo: one option each for Deezer and Spotify, from the IDs linked on the artist. expectedCustomImage is the current photo; pass it to Choose a provider photo so a stale choice is refused.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin. Kept in this tab only.

Query

artistIdstringrequired

The artist's ID (a UUID).

cURL
curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/artist/photo-choice?artistId=aab92f80-f9e1-4299-aa33-7dd85c8de5d3'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. The user must be the artist's approved claimant or a Music Nerd admin.

Query Parameters

artistIdstringrequired

The artist's ID (a UUID).

Response

application/json

The two provider options. Cache-Control: no-store.

statusstring · enumrequired

Values: "ok"

expectedCustomImagestring | nullrequired

The artist's current customImage. Send it back as expectedCustomImage when choosing.

optionsarray<object>required

One entry per provider, Deezer first, whether or not the artist has that provider linked.

Item properties for options
sourcestring · enumrequired

Which provider the photo comes from.

Values: "deezer", "spotify"

providerIdstring | nullrequired

The provider ID linked on the artist, trimmed; null when none is linked.

imageUrlstring | nullrequired

The provider's photo for that ID (https only); null when there is no ID, no photo, or the provider could not be reached.