Maestro.fm

for Developers

Playlists/Remove Song From Playlist

From MaestroWikiAPI

Jump to: navigation, search

Playlists - Remove Song From Playlist

Returns XML to remove a song from a playlist.

URL

http://www.maestro.fm/maestro_api?api_access_key=api_access_key&type=manage_playlist&user_email=user@email.com&user_session_key=user_session_key&media_key=item_identifier_for_song&playlist_key=item_identifier_for_playlist&action=remove


Formats

XML


HTTP Methods

GET


Parameters

api_access_key: Key given to you when you applied to use this API

type: the call type, in this case it must be "manage_playlist"

user_email: user's email address associated with their Maestro account

user_session_key: user's user_session_key value provided on Account/Login

playlist_key: This is the <item_identifier> from a playlist <item>

media_key: This is the <item_identifier> from a song <item>

action: Possible options [remove]

Successful XML

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username>danesc</request_username>
		<request_date>20090518005440</request_date>
		<request_type>manage_playlist</request_type>
		<total_pages>1</total_pages>
		<current_page>1</current_page>

		<number_of_results>1</number_of_results>
		<lines_per_page>1</lines_per_page>
	</summary>
	<response>
		<user_session_key>mbeWBYP1Ry9eKm4l1K8M</user_session_key>
		<user_valid>1</user_valid>
		<user_display></user_display>

		<section>
			<section_description>Manage Playlist</section_description>
			<section_total_media></section_total_media>
			<item>
				<item_type></item_type>
				<item_identifier>CuUahbUEchd2IfxsqyNW2xXXB5c0iKuuEOVwzzBb</item_identifier>
				<item_playlist_name>a%20colorful%20playlist</item_playlist_name>

				<item_message>Media has been removed from the playlist.</item_message>
				<item_action_success>1</item_action_success>
				<item_found_in_playlist>0</item_found_in_playlist>
 			</item>
		</section>
	</response>
</maestro>


Failed XML

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username></request_username>
		<request_date>20090518005157</request_date>
		<request_type>manage_playlist</request_type>
		<total_pages></total_pages>
		<current_page></current_page>
		<number_of_results></number_of_results>

		<lines_per_page></lines_per_page>
	</summary>
	<response>
		<user_session_key>mbeWBYP1Ry9eKm4l1K8</user_session_key>
		<user_valid>0</user_valid>
		<user_display>Username and password do not match.</user_display>
	</response>

</maestro>


Back to API Methods

Personal tools