With the standard API in QuickFile you can easily define applications at the account level and we will give you a few authentication credentials you can use to make calls to the API. This is great when you just want to create some bespoke tool for your own use, but becomes problematic when you want to develop something for the wider community.
As an API Partner we provide you with a framework you can use so you can tell other users about your API product e.g.
- What is it called?
- What does it do?
- What permissions will it require?
- What is the cost to the end-user?
- Is there a website with more information?
This information is visible to all QuickFile users and will allow them to grant access to the application from the 'Services' area in their QuickFile account.
Once access has been granted the end-user will receive a token they can enter into your application with their account number. This combination can then be used to access their regular API credentials and interface with all granted endpoints defined in the product.
Becoming an API Partner takes just a few clicks. First head over to the "My Apps" section of your account, here you will see a link "Become an API Partner". Click this link and we'll set you up with a new Partner Dashboard where you can start defining your products.
Now you are an API Partner you will want to tell other QuickFile users about your product. On your API Partner Dashboard click the green button 'Create a product'. This will open a dialogue box where you can enter some information about the product you have built.
Once your product details have been saved it will convert to 'STAGING' status. While your product is in staging you will be able to test your integration on your account, you can also add up to 5 additional test accounts. You can add a test account to your list by clicking on the corresponding edit link for the product in question.
QuickFile includes a Marketplace area where your custom products will be accessible to the wider QuickFile community. Before a product can become generally available on the Marketplace you will first need to deploy that application, you should perform this task once you have thoroughly tested it's functionality while in staging mode.
To deploy your application click on the corresponding 'view' link and click the green 'Deploy Product' button:
In most cases a member of the QuickFile team will review your application within 24 hours. Once reviewed we will notify you by email and publish your product to the QuickFile Marketplace area.
As an API partner you will need to make calls to a dedicated endpoint that will enable you to retrieve your end-user's regular API credentials, this will then permit you to make all necessary API calls defined in your product specification.
The Partner endpoint for retrieving API credentials is as follows:
Simply make a HTTP post request passing two variables in the body:
You will also need to set your content type to
The token is the value supplied by the end user and generated on the marketplace when an end-user activates a new product.
The md5 value is a hash that is used as a signature for the call. This MD5 hash should be created by concatenating the end-users account number with your secret key (Visible on your partner dashboard)
There's a useful tool here for generating your own MD5 hash.
If the request is successful the partner API will return a HTTP 200 status code with some JSON that will provide you with an
api_key and an
application_id, these credentials can then be used by all other methods within the QuickFile API to authorise your calls.
If the credentials supplied could not be verified you would typically receive a HTTP 400 response.