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 --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

PreviousIntroductionNextGet Started

Last updated