From MaestroWikiAPI

Favorites - Add Favorites

Returns XML to add the favorites associated to a song. This can be song, album, artist, DJ, playlist. Use <item_favorite_type> to determine what to favorite and <item_identifier> as the ID

URL

http://www.maestro.fm/maestro_api?api_access_key=api_access_key&type=manage_favorites&user_email=user@email.com&user_session_key=user_session_key&identifier=item_identifier&favorite_type=item_favorite_type&action=add

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_favorites"

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

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

identifier: This is the <item_identifier> from <item>

favorite_type: This is the <item_favorite_type> from <item>

action: Possible options [add]

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>20090518014349</request_date>
		<request_type>manage_favorites</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 Favorites</section_description>
			<section_total_media></section_total_media>
			<item>
				<item_type></item_type>
				<item_identifier>12982</item_identifier>
				<item_favorite_type>artist</item_favorite_type>

				<item_message>Favorite Action Successful</item_message>
				<item_action_success>1</item_action_success>
				<item_favorite_status>1</item_favorite_status>
			</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>20090518014442</request_date>
		<request_type>manage_favorites</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>mbeWBYP1Ry9Km4l1K8M</user_session_key>
		<user_valid>0</user_valid>
		<user_display>Username and password do not match.</user_display>
	</response>

</maestro>

Back to API Methods