1. Request Manifest File List
The Displayble Content Export (DCE) workflow begins with a request for a manifest file list. Values in the list will be in the form of URL paths which will be used in the next step.
Request
Path
GET https://[stg.]api.bazaarvoice.com/dce/v3/data
Path tokens
Name | Description |
---|---|
[stg.] |
Optional subdomain indicating the request should use the non-production environment. Omit to use production. Learn more at the Reference section. |
Headers
Host: [stg.]api.bazaarvoice.com
X-Bazaarvoice-Passkey: {DCE_PASSKEY}
X-Bazaarvoice-Signature: {SIGNATURE}
X-Bazaarvoice-Timestamp: {TIMESTAMP}
Refer to the Reference section for details on the headers and their values.
Access signature values
Replace the {SIGNATURE}
token above with the encrypted string generated using the algorithm described in the "Creating the Access Signature" section.
passkey={DCE_PASSKEY}×tamp={TIMESTAMP}
Replace the tokens above with the appropriate values as described below:
Name | Description |
---|---|
{DCE_PASSKEY} |
This is the same value communicated with the |
{TIMESTAMP} |
A Unix timestamp in milliseconds. This is the same value communicated by the ⚠ Using seconds or any increment other than milliseconds will cause your request to fail |
Response
Response will be a JSON object containing URL paths corresponding to available manifests. The following demonstrates a typical response:
{
"manifests": [
{
"version": "v2",
"fulls": [
{
"date": "2017-07-31",
"path": "/manifests/full/2017-07-31/v2/manifest.json"
},
{
"date": "2017-07-24",
"path": "/manifests/full/2017-07-24/v2/manifest.json"
},
{
"date": "2017-07-17",
"path": "/manifests/full/2017-07-17/v2/manifest.json"
}
],
"incrementals": [
{
"date": "2017-07-31",
"path": "/manifests/incremental/2017-07-31/v2/manifest.json"
},
{
"date": "2017-07-30",
"path": "/manifests/incremental/2017-07-30/v2/manifest.json"
},
{
"date": "2017-07-28",
"path": "/manifests/incremental/2017-07-28/v2/manifest.json"
}
]
}
]
}
Full manifests contain all displayable Conversations data and are generated once a week. Use the most recently generated manifest to get a complete snapshot of your Conversations data.
Incremental manifests are generated in response to new and modified content over the previous 24 hour period. The absence of an incremental manifest for a particular period indicates that there is no new or updated content processed during that period.
Updated 2 months ago