Authentication

The EtherOne API uses APP keys to authenticate requests. You can view and manage your APP keys in the EtherOne Dashboard

Your APP keys carry many privileges, so be sure to keep them secure! Do not share your secret APP keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Authentication to the API is performed via a JSON request. Provide your APP key and APP Secret in the JSON body, this will generate an access token to be used on every request when accessing the API. Please note that this access token expires every 180 seconds

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

You can generate an APP key from your Dashboard at any time.

Make an authentication request

Curl

curl --location --request POST 'https://openapiuat.etheroneafrica.com/api/v1/authenticate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "b3a56190-2f99-427f-b90f-33b0a891095f",
    "appSecret": "112a4a04-feb6-421a-a4b0-1649226226cf"
}'

Create an auth token

Create Auth Token.

POST https://openapiuat.etheroneafrica.com/api/v1/authenticate

Creates a new auth token

Request Body

Name	Type	Description
appKey*	string	AppKey got from the EtherOne Dashboard
appSecret	string	AppSecret got from the EtherOne Dashboard

200 Access token created

{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MCwiYnVzaW5lc3NfaWQiOjEsInN1YnNjcmlwdGlvbnMiOm51bGwsImV4cCI6MTY4OTA4NDIyOH0.v8ua_8ibu6xktHR_xs_325WS4RaHH7DNPjCRBsfj9uU",
"expires_in": "2023-07-11T17:03:48.077965+03:00",
"token_type": "bearer"
 }

401 Authentication failed