getURLHash

Description

Returns an encoded URL that allows blog publishers to access the Publisher Control Panel without having to login. The URL will expire after 60 minutes.

The encoded URL (hash login) can log users into the Publisher Control Panel from any non-Blogware interface. This could be a login screen that you've created on your website, or your user can access Blogware from another interface such as webmail, where they are already logged-in.

Syntax

reseller.getURLHash(version, username, password, blog_admin_url, blog_hostname, locale, timezone, skin)

Request Fields

•	version - Specifies the version number of the API. Set this to "1.3". This value is currently ignored, but will be useful for API changes in future versions.

•	username - Your reseller account username. May be empty if HTTP basic authentication is being used and the authenticated username is your reseller user name.

•	password - Your reseller account password. May be empty if HTTP basic authentication is being used.

•	blog_admin_url – The specific admin page that you want to access without a login. This field is required and may not be empty. Allowed values:

Dashboard page: cmd=display_themes

Post page: cmd=post_article

Post Manager page: cmd=view_category

Look & Feel page: cmd=display_themes

Favorites page: cmd=view_blogrolls

File Manager page: cmd=manage_files

Settings & Security page: cmd=edit_settings

•	blog_hostname – The hostname of the blog within the reseller's realm. This field is required, and may not be empty (examples: catmas.blogware.com, myblog.example.com).

•	locale – The language used when the blog is displayed. Allowed values: en_US, en_CA, en_GB, fr_FR, and es_ES. This field may be empty, and if not submitted, the blog's locale will be used.

•	timezone – The timezone used to display dates and times. This field may be empty, and if not submitted, the blog's timezone will be used (for example: US/Alaska, Canada/Eastern, Asia/Tokyo).

•	skin – The skin that is used to display the blog's pages. This field may be empty, and if not submitted, the blog's/reseller's layout style will be used.

Response Fields

Returns a string that provides the encoded URL to access the Publisher Control Panel for the specified blog (hostname). The URL will expire after 60 minutes.