Maestro.fm

for Developers

Account/Register

From MaestroWikiAPI

Jump to: navigation, search

Create or Register a New Account

Returns XML verifying user's registration.

URL

http://www.maestro.fm/maestro_api?api_access_key=api_access_key&type=register&user_email=user@email.com&password=password&password_confirm=password&username=some_username&first_name=some_first_name&last_name=some_last_name&gender=m_or_f&referral_type=your_company_name&referral_specify=your_product_name&terms_of_use=yes_or_null


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

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

password: user's password associated with their Maestro account

password_confirm: user's verification to the password

username: user's desired username for their Maestro account

first_name: user's first name

last_name: user's last name

gender: user's gender, possible values (m|f)

referral_type: this is your company's name, which owns the product using this API

referral_specify: this is your product's name using this API. We use it to track where the new registrations came from. Thank you!

terms_of_use: user agrees or disagrees to the terms of conditions. Possible values (yes|null)


Successful XML

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username>someusername</request_username>
		<request_date>20090517092100</request_date>
		<request_type>register</request_type>
	</summary>
	<response>

		<user_session_key>2Pl47zkJtV3UOjtIdQr0</user_session_key>
		<user_valid>1</user_valid>
		<user_display></user_display>
	</response>
</maestro>


Failed XML

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username>some_username</request_username>
		<request_date>20090517091812</request_date>
		<request_type>register</request_type>
	</summary>
	<response>

		<user_session_key></user_session_key>
		<user_valid>0</user_valid>
		<user_display>Your username should contain letters and numbers only.</user_display>
		<first_name>some_first_name</first_name>
		<last_name>some_last_name</last_name>
		<user_email>user@email.com</user_email>

		<username>some_username</username>
		<gender>m_or_f</gender>
		<terms_of_use>yes</terms_of_use>
	</response>
</maestro>


Back to API Methods

Personal tools