Certification

DFINERY uses API tokens to determine whether a request sent by a user is an authenticated request. All API requests must include an API token in the header. API tokens can be issued through the DFINERY console.

DFINERY's API tokens are divided into Import API and Export API tokens. Import API tokens are mainly used when sending customer data to DFINERY (Event, Identity, Profile API). Export API tokens are mainly used when customers extract data loaded into DFINERY (Export API).

API token issuance

After logging in to the DFINERY Console, you can check it by Service Management going to the left menu ( > > ​​). Key information API Token Service Management Key information API Token

• Token issuance/reissue/deletion can only be done by service administrators.

• API tokens are automatically issued when a service is created and can only be reissued.

Request via API token

Import API

Import API tokens access_tokencan be used by adding a value to the request header.

curl -X GET "https://openapi.dfinery.ai/api/v1/..." \
-H "access_token: ${your-import-api-token}"

Export API

Emport API tokens Authorizationcan be used by adding a value to the request header.

curl -X GET "https://openapi.dfinery.ai/api/v1/..." \
-H "Authorization: Bearer ${your-export-api-token}"

Reissue API token

DFINERY can only issue one API token per service. If you want to change the token, you can do so by clicking the reissue button (Service Management > Key information > API Token > Reissue).

When reissued, the existing token can only be used for 2 weeks. Please change to a reissued token within 2 weeks.

API token related response codes

Please refer to the Response tab for token-related response codes and common errors and codes.