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.

InputParameters:

  • 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?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:

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

Example Request

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

Example Response

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