Introduction
The Datenly API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses.
Each response contains status and description fields, "true" in status and "succeeded" in description means your request is processed successfully, otherwise, the description field describes the error
Authentication
Keys
Each product has its own keys such as:
There are for keys three each product, public key
, private key
, and secret key
.
Public key
You can safely use this key clearly in your code.
Private key
Key to confirm that you are authorized to use your application. It should be kept in a private and secure place
Secret key
Secret key allows you to decrypt sensitive data, such as user data, it's important to protect it well.
You can find your API keys on Api - Flows
Datenly
To use the API, you must have, private key
CommerzData
To use the API, you must have, public key
, private key
, and secret key
Generate a token
Datenly Api uses OAuth 2.0 protocol to authorize calls. OAuth is an open standard that many companies use to provide secure access to protected resources.
Authentication, which uses a Bearer Token, is also known as application-only authentication. A Bearer Token is a byte array of unspecified format that you generate using a script like a curl command. More information about this feature can be found on OAuth's official documentation.
Request for all endpoints except commerzdata
curl -X GET "https://api.datenly.com/api/authentication" \
-H "key: <Private_key>"
Request for commerzData
Secret key is only available one time on your portal
Datenly expects for the keys and app ID to be included in a header that looks like the following:
curl -X GET "https://api.datenly.com/api/commerzdata/authentication" \
-H "app: <App_ID>"
-H "key: <Private_key>"
-H "secret: <Secret_key>"
Response
Using Token
All Datenly APIS endpoints need to be identified by token
Datenly expects for the token to be included in Api requests in a header that looks like the following:
curl -X GET "https://api.datenly.com/api/<endpoint>" \
-H "Authorization: <token>"