API Methods: auth.getUserAuthorization

Description

See the OAuth Specification section Obtaining User Authorization

Unlike the other OAuth methods, and unlike any other API method, this is actually a page to which a user is redirected to obtain their authorization.
The parameters to this method may only be passed as GET parameters, since the user is being redirected here.

This method does not take the 'format' parameter, as it will display an HTML page asking the user if they wish to allow the requesting application to access their account.

Required parameters

  • oauth_token:
    The Request Token obtained in the previous step.
  • permissions:
    'W' to indicate the application wants read/write access, or 'R' to indicate that the application wants read-only access to the user's account.

Optional parameters

  • oauth_callback:
    The Consumer MAY specify a URL the Service Provider will use to redirect the User back to the Consumer when Obtaining User Authorization (Obtaining User Authorization) is complete.

Global parameters

  • None - The auth methods are special and do not support the global parameters at all.

Example response

None, the user will be redirected once they give their consent.