API

Getting Started

Welcome to the Alfafile API!

To use Alfafile API you require the following:

  • A alfafile account. You can open a Alfafile account here
  • Access Token. You can create a access token by using either of the Alfafile API user/login method

We provide client API libraries in a variety of popular languages.

Since Alfafile serves a huge client base, programming errors in software tools can cause an DDOS attack to the Alfafile servers. When programming software apps, always keep in mind that your tool might be used by many people at the same time. So make sure you do not kill our API servers, which might cause some big issue. Make sure your program STOPS retrying a failed request after 3 tries. Always make sure you do not make more API calls than necessary.

You can of course also call the API via POST or GET Our API will give answer in JSON

Be careful when giving too many wrong passwords. The password brute-force protection will block your IP when you enter too many wrong passwords.

Success response example:
        
{
   "response":{
      ....
   },
   "status":200,
   "details":null
}
        
    

This api answer has data in response object . Status has code 200. Details field is empty and can be ignored.

Fail response example:
        
{
   "response":null,
   "status":401,
   "details":"Unauthorized. Wrong login or password."
}
        
    
This reposnse does not have any data in response object. "Sttatus" object has error code . "Details" object has information regarding error. The best is if you just output the string to the user. The string is self-explanatory and every user should know what went wrong.