Choose a language javascript

Making Requests

Here are the building blocks to set up your first request.

Authentication

POST /token

import axios from 'axios';
const getToken = async () => {
const response = await axios({
method: 'post',
url: 'https://api.felloh.com/token',
headers: {
'Content-Type': 'application/json'
},
data: JSON.stringify({
"public_key": process.env.PUBLIC_KEY,
"private_key": process.env.PRIVATE_KEY,
},
),
});
return response.data;
};

RESPONSE

{
"data": {
"expiry_time": 1657485864,
"type": "BEARER",
"token": "vXdvRb0DIw9DSnC4NCeCWmjmI5dJmeMrl0Esg2HG6EeaHZmcaYtymifw7YVCySCAuAEpruJx8fZBAX0FYmhfOc5WSzp9uDRQ3xdC06JTIDLVVmngvfFRkxCsPaV4oqmYCZcwe6oldLhWZnHE2EPUbc7OG3W3klyGQg8u00UmwqXeLIgA8CryoNGgA3Y3mitxKV7Y2uhlmPySP0BQ1K64ml8bJMLoLbQj3PMpt1eKwJdlETCTRjW"
},
"errors": [],
"meta": {
"code": 200,
"reason": "OK",
"message": "The request was successful",
"request_id": "10610d99-42cf-41dd-9d23-128df906544c"
}
}

All requests to our API need to be authorised. You can generate a public and private key from the dashboard and can generate further keys via the API or dashboard (if your initial token has permission to do so).

Felloh uses public & private keys to generate a bearer token to allow you to access our API's.

Once you have generated a public and private key using our dashboard, you can generate a Bearer token to make requests against our API.


Transport Encryption

All requests are encrypted using TLS 1.2 or TLS 1.3.

All API requests must be made over HTTPS. Any calls made over unencrypted HTTP will fail.


MIME Types

REQUEST

Accept: application/json

All responses from the API are in JSON format with UTF-8 encoding. An Accept header is required with every request:

RESPONSE

Content-Type: application/json

All request bodies sent to the API should be in JSON format. A Content-Type header is required whenever you're sending a request body (i.e. for POST and PUT requests):


Request ID

RESPONSE

{
"meta": {
"request_id": "10610d99-42cf-41dd-9d23-128df906544c"
}
}

All responses will contain an 'request-id' in the response. The value uniquely identifies the request/response.

We recommend you keep track of this for debugging purposes. When interacting with support, providing this will allow the team to give you prompt and personalised support.