The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

The following documentation is automatically generated. Please do not edit this file, but rather the original, inline with Net::Async::Spotify::API::Generated::Follow at lib/Net/Async/Spotify/API/Generated/Follow.pm (on the system that originally ran this). If you do edit this file, and don't want your changes to be removed, make sure you change the first line.

NAME

Net::Async::Spotify::API::Generated::Follow - Package representing Spotify Follow API

DESCRIPTION

Autogenerated module. Based on https://developer.spotify.com/documentation/web-api/reference/#reference-index Check crawl-api-doc.pl for more information.

METHODS

check_current_user_follows

check_current_user_follows - Get Following State for Artists/Users

Check to see if the current user is following one or more artists or other Spotify users.

with Request details being:

Authorization

Type: string | Required: required A valid user access token or your client credentials. Requires the user-follow-read scope.

query_parameter

ids

Type: string | Required: required A comma-separated list of the artist or the user Spotify IDs to check. For example: ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q. A maximum of 50 IDs can be sent in one request.

type

Type: string | Required: required The ID type: either artist or user.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 200 OK and the response body contains a JSON array of true or false values, in the same order in which the ids were specified. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

check_if_user_follows_playlist

check_if_user_follows_playlist - Check if Users Follow a Playlist

Check to see if one or more Spotify users are following a specified playlist.

with Request details being:

header

Authorization

Type: string | Required: required A valid user access token or your client credentials. Requires the playlist-read-private scope if a private playlist is requested.

path_parameter

playlist_id

Type: string | Required: required The Spotify ID of the playlist.

query_parameter

ids

Type: string | Required: required A comma-separated list of Spotify User IDs ; the ids of the users that you want to check to see if they follow the playlist. Maximum: 5 ids.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 200 OK and the response body contains a JSON array of true or false values, in the same order in which the ids were specified. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

follow_artists_users

follow_artists_users - Follow Artists or Users

Add the current user as a follower of one or more artists or other Spotify users.

with Request details being:

header

Authorization

Type: string | Required: required A valid user access token or your client credentials. Requires the user-follow-modify scope.

Content-Type

Type: string | Required: optional Required if IDs are passed in the request body, otherwise ignored. The content type of the request body: application/json

json_body_parameter

ids

Type: array[string] | Required: required A JSON array of the artist or user Spotify IDs. For example: {ids:["74ASZWbe4lXaubB36ztrGX", "08td7MxkoHQkXnWAYD8d6Q"]}. A maximum of 50 IDs can be sent in one request. Note: if the ids parameter is present in the query string, any IDs listed here in the body will be ignored.

query_parameter

ids

Type: string | Required: required A comma-separated list of the artist or the user Spotify IDs. For example: ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q. A maximum of 50 IDs can be sent in one request.

type

Type: string | Required: required The ID type: either artist or user.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 204 No Content and the response body is empty. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

follow_playlist

follow_playlist - Follow a Playlist

Add the current user as a follower of a playlist.

with Request details being:

header

Authorization

Type: string | Required: required A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the user.Following a playlist publicly requires authorization of the playlist-modify-public scope; following a playlist privately requires the playlist-modify-private scope. See Using Scopes.Note that the scopes you provide relate only to whether the current user is following the playlist publicly or privately (i.e. showing others what they are following), not whether the playlist itself is public or private.

Content-Type

Type: string | Required: required The content type of the request body: application/json

json_body_parameter

public

Type: boolean | Required: optional Defaults to true. If true the playlist will be included in user’s public playlists, if false it will remain private.

path_parameter

playlist_id

Type: string | Required: required The Spotify ID of the playlist. Any playlist can be followed, regardless of its public/private status, as long as you know its playlist ID.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 200 OK and the response body is empty. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

get_followed

get_followed - Get User's Followed Artists

Get the current user’s followed artists.

with Request details being:

header

Authorization

Type: string | Required: required A valid user access token or your client credentials. Requires the user-follow-modify scope.

query_parameter

after

Type: string | Required: optional The last artist ID retrieved from the previous request.

limit

Type: integer | Required: optional The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

type

Type: string | Required: required The ID type: currently only artist is supported.

and Response Objects being:

- paging object

On success, the HTTP status code in the response header is 200 OK and the response body contains an artists object. The artists object in turn contains a cursor-based paging object of Artists. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

unfollow_artists_users

unfollow_artists_users - Unfollow Artists or Users

Remove the current user as a follower of one or more artists or other Spotify users.

with Request details being:

header

Authorization

Type: string | Required: required A valid user access token or your client credentials. Requires the user-follow-modify scope.

Content-Type

Type: string | Required: optional Required if IDs are passed in the request body, otherwise ignored. The content type of the request body: application/json.

json_body_parameter

ids

Type: array[string] | Required: optional A JSON array of the artist or user Spotify IDs. For example: {ids:["74ASZWbe4lXaubB36ztrGX", "08td7MxkoHQkXnWAYD8d6Q"]}. A maximum of 50 IDs can be sent in one request. Note: if the ids parameter is present in the query string, any IDs listed here in the body will be ignored.

query_parameter

ids

Type: string | Required: required A comma-separated list of the artist or the user Spotify IDs. For example: ids=74ASZWbe4lXaubB36ztrGX,08td7MxkoHQkXnWAYD8d6Q. A maximum of 50 IDs can be sent in one request.

type

Type: string | Required: required The ID type: either artist or user.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 204 No Content and the response body is empty. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

unfollow_playlist

unfollow_playlist - Unfollow Playlist

Remove the current user as a follower of a playlist.

with Request details being:

header

Authorization

Type: string | Required: required A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the user.Unfollowing a publicly followed playlist for a user requires authorization of the playlist-modify-public scope; unfollowing a privately followed playlist requires the playlist-modify-private scope. See Using Scopes.Note that the scopes you provide relate only to whether the current user is following the playlist publicly or privately (i.e. showing others what they are following), not whether the playlist itself is public or private.

path_parameter

playlist_id

Type: string | Required: required The Spotify ID of the playlist that is to be no longer followed.

and Response Objects being:

- error object

On success, the HTTP status code in the response header is 200 OK and the response body is empty. On error, the header status code is an error code and the response body contains an error object.Try in our Web Console

INHERITED METHODS

Net::Async::Spotify::API::Base

call_api, decode_response, new, parse_response, spotify