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:
header
- 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