Home > Developers > API Methods Reference Manual: auth/login

auth/login

Overview

Login is required when entering the API framework. This method redirects the user to the project's callback URL (this is the "homepage" for the API developer's application as a "silent," or non-registered, SharedBook user), adding the authToken as a parameter to the callback URL.

The authToken is valid for 60 minutes. After that, the user must login again.

Related methods: auth/getSessionToken

HTTP Method

POST

URL

http://api.sharedbook.com/v0.6/auth/login

User Authentication

None

Request Parameters (Required)

• apiKey: The API developer's API key

Response Formats

The response is an HTTP redirect to the callback URL provided by the client during registration, followed by an 'authToken' parameter:

[callback-url]?authToken=[auth_token]

Error Codes

General Error Codes

Example

(See the Method Syntax page for details.)