Authentication APIs

/api/authentication/login

Authenticates existing Filemail user. Returns logintoken - which is used in all subsequest API requests to identify user. Note that authentication is optional - anonymous users can still send files through the Filemail API. The main advantages of having a Filemail account and authenticating is that files can be downloaded more times, and that they are available for a longer period of time.

A user can have maximum one logintoken per device(source) at any given time. If a user logs in twice with source = "Web" - then only the last logintoken will work. A logintoken expires automatically after 10 days of inactivity - or when the user invokes /api/authentication/logout

InputParameters:

  • apikey - Text - Your Api Key. Required.

  • username - Text - The email address of the user. Required.

  • password - Text - The password of the user. Required.

  • source - Text - Devicetype. Required. Valid alternatives: Web, Iphone, Ipad, WindowsPhone, WindowsTab, AndroidPhone, AndroidTab, Outlook, Desktop, Downloader, Thunderbird

Example Request

API Address: https://www.filemail.com
GET /api/authentication/login?apikey=asidj98hasdopu9h09sd7h&username=diego@gmail.com&password=12345

Example Response

{
  "responsestatus": "ok",
  "logintoken": "9dcdb15147534cb19594bd3e2c3f6bd9"
}

/api/authentication/logout

Destroys logintoken of a user that is logged in.

InputParameters:

  • apikey - Text - Your Api Key. Required.

  • logintoken - Text - Retrieved by former invokation of /api/authentication/login.

Example Request

API Address: https://www.filemail.com
GET /api/authentication/logout?apikey=asidj98hasdopu9h09sd7h&logintoken=gjd93jhf85ng93jf94jgjkf94

Example Response

{
  "responsestatus": "ok",
  "logintoken": "9dcdb15147534cb19594bd3e2c3f6bd9"
}