To start using Digital Experience Cloud data collection and personalization API, you first need to have:
NOTE: If you do not have a DEC account, contact email@example.com for information about getting a trial version of DEC, as well as purchasing DEC licenses.
Next, you can proceed with getting your authorization token and obtaining the data center API key. You will need both to use the majority of DEC endpoints.
By calling the following endpoint, you agree to the latest DEC terms and conditions.
NOTE: You can obtain the full text of the terms and conditions from the Cloud services agreement.
Body is not required.
To use the secured DEC endpoints, you need to obtain an authorization token. You do this by using the resource described below. By concatenating the access_token and token_type properties of the response, you get the string you need to use in the Authorization header in all secured DEC endpoints. For example, if the access_token returned is “123456” and the token_type is “bearer”, your DEC authorization is bearer 123456.
NOTE: The token returned from the /admin/v1/users/issue-access-token endpoint is valid for 60 minutes.
Another way of authorizing is by creating an authorized application in DEC Web app. Navigate to the Administration panel of the data center and open the Authorized applications tab page. Once you generate a token, to place it in the Authorization header, concatenate it with appAuth. For example, if your token is “78910”, you need to provide appAuth 78910 to authenticate.
NOTE: Authorized applications can only access the personalization endpoints of DEC. For more information, see Personalization API endpoints.
No parameters are required for this endpoint.
In the example above, the value that you need to provide to the Authorization header of the secured DEC API server endpoints is bearer ebJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYmYiOjE1MTc5MzkzMjMsImV4cCI6MTUxNzk0MjkyMywianRpIjoiNDYxMzhmZjQ3YTg1NDJlZWI3N.
To work with the majority of DEC endpoints, you are required to provide the API key of the data center. The reason is that most of the data, related to DEC, is data center-bound. The following sections explain the two ways of obtaining the data center API key.
Use the following API resource to obtain the API keys of the data centers you need access to.
You can filter the data centers by some of their properties:
For more information, see Data center API data type.
You can work with two DEC API versions, which also reflect the Sitefinity CMS you are working with:
RECOMMENDATION: We recommend working with the newer version of the DEC API.
Back To Top