Home    
Home  >  API & Developers

Authentication

In order to interact with the DataKnowl API, your application must authenticate.

Authentication is based on two keys:

- AccessKeyID
- SecretAccessKey

To authenticate using these master keys, use HTTP Basic Auth (RFC 7617) with the username set to your AccessKeyID and the password set to your SecretAccessKey.

Your AccessKeyID and SecretAccessKey can be found on your Developers Dashboard.

The AccessKeyID is used to identify the user. SecretAccessKey is never sent or transmitted.

Authentication is implemented by passing parameters via HTTP headers

Parameters are:

Header Value Description
Authorization Authorization: Basic <credentials>
AccessKeyId Key used to identify the user
Timestamp The timestamp of the request
Signature The signature Empty for Basic Auth

Example


curl -v -X POST -H "Content-type: application/x-www-form-urlencoded; charset=UTF-8"
                -H "AccessKeyId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 
                -H "Timestamp: 1571411606301" 
                -H "Signature: " 
                -u {AccessKeyId}:{SecretAccessKey}
                -d "sequence:text=Where is the nearest office ?" 
                https://eu-central.dcs.dataknowl.com/v1/vagent/{VAGNT}/conv/{VACNV}/sequence/process

where:
{VAGNT} is the V-Agent RID
{VACNV} is the Conversation RID, or NEW to start a new conversation

© 2019 Complexity Intelligence, LLC