Getting Started

• Overview
• API URL's
• API Libraries
• Resources
• Open Source Applications

API Methods

• Authentication
  • login
  • logout
• Locker Data
  • accountData
  • createAccount
  • lastUpdate
  • lockerData
  • lockerSearch
  • lockerFileExists
  • lockerStats
• Playlists
  • playlistAdd
  • playlistDelete
  • playlistEdit
  • playlistTrackAdd
  • playlistTrackDelete
  • playlistTrackReorder
• Locker Storage
  • albumArtGet
  • lockerDelete
  • lockerGet
  • lockerPut
  • lockerPlay

login

The login method attempts to authenticate the received user credentials and setup a session to be used with all subsequent requests. On success the 'status' parameter is set to 1, and a valid session id is returned. If authentication fails the 'status' parameter is set to 0, and the 'errorMessage' parameter is populated with appropriate error messages detailing what caused the call to fail.

Parameters

username (required): A valid MP3tunes account username.
password (required): A valid MP3tunes account password.
partner_token (required): A valid partner token. See Overview for more information.

Since the login call involves sending users login credentials to MP3tunes servers, the request should be made over SSL to shop.mp3tunes.com. See API URL's for the full authentication URL.

Example Request:

https://shop.mp3tunes.com/api/v1/login?output=xml&username=demo@mp3tunes.com
&password=demo&partner_token=9999999999

Example Response:

  1
  xxx2188b626c678a42a681cfc5d36xxx
  user@example.com