Get started with your Falu integration
We recommend you read this guide to:
- Help us make your initial integration and testing experience as smooth as possible.
- Check some best practices on how to manage your integration.
- Get guidance on going live for the first time.
Falu brings you an integrated infrastructure comprising three main services: messaging, identity verification, and payments. You can configure and manage these services using either the Falu Dashboard or through our APIs.
Using the Falu APIs
In this release, we have exposed API endpoints for accessing the above three services. The APIs are built on REST; data entities are represented as HTTP resources and are accessed using HTTP requests. Request parameters and responses - including errors - are encoded in JSON.
The APIs response status and error codes comply with HTTP status codes as defined in RFC 2616. You can invoke our API endpoints using REST clients, such as Postman or Reqbin, and command line tools like Curl. To get you started, we have provided code samples in various languages, such as Curl and C#. Sample JSON responses for each APIs request have also been availed.
Some preliminary steps
Before you can use the APIs, it is recommended that you test them and your keys. Below, we outline how you can achieve this exercise using Reqbin.
Step 1: Get API Keys
You can get two types of API keys from your Dashboard depending on its configuration: Sandbox keys for testing and live keys to generate live requests.
1. Sandbox keys
You can use the sandbox to test your technical integration to simulate API requests.
You should test with a sandbox API key before going live. Sandbox requests return templated responses and you won't be charged. To generate sandbox keys:
- Go to your Dashboard.
- Toggle the button on the top right corner to Test mode.
- Select Developers.
- Select API Keys.
- Select Create API Key.
Give your API key a suitable name, description, and when it will expire. Optionally, you can provide allowed IP network addresses through which the key may be used and you can specify the type of Falu services that the key will be allowed to access.
Make sure you are using the right API key. Read the API Keys guide for more details.
2. Live keys
Live tokens are issued after verification of your workspace. You can generate live API keys following the same procedure as when getting Sandbox keys, but with your Dashboard in live mode. Note that new live mode keys are redacted from your Dashboard after you have accessed them for the first time.
Keep your keys secure:
Your keys are modifiable in the API Keys section of the Dashboard. For each public or secret key, you can click on Roll/ update secret under Actions to generate a new key.
Step 2: Test the API and keys
As stated before, our APIs are built on REST and can be invoked using clients such as Postman. Below is a sample test-run of our `messages` API endpoint.
1. Create, configure, and get your API keysFrom your Dashboard, create a Secret key to allow you to access the messages API from the public domain. Also, configure the Allowed Endpoints to the type of API you want to use.
2. Create a test call to the APICopy the key and go to your preferred API client to test it. In this example, we use Reqbin to do a GET request to the messages API. Visit our API reference to view the structure of our API request headers, including the base URL and the status messages and their meanings.
The test above can give you some insights into how Falu API calls work and how to manage them. For example, checking the Headers section of the response will show you that the rate limits is capped at 100 per minute. Read more about this in the rate limits guide.
To avoid being rate-limited, we recommend:
- running non essential or routine batch API jobs outside your peak hours
- throttling batch jobs
- prioritizing requests that are essential to your application.