--- updatedAt: 2026-03-30T09:24:59.000Z agentTools: projectIndex: https://developers.bazaarvoice.com/v1.0-DCE/llms.txt --- # DCE HTTP Service - v3 This page contains reference documentation for version 3 of the Displayable Content Export (DCE) HTTP service. ## Environments The DCE supports the following environments: [block:html] { "html": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Environment	Domain	Description
Staging	`https://stg.api.bazaarvoice.com`	Used while developing your application.
Production	`https://api.bazaarvoice.com`	Used when your application is complete.

" } [/block] ## Required headers All DCE requests must include the following headers: [block:html] { "html": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name	Description
`Host`	\n Environment, staging or production, that will process the request. \n ⚠ If you are getting 403 response from S3 then you may exclude Host from your header for the GET request of data sets from S3. \n
`X-Bazaarvoice-Passkey`	The passkey key described in the Credentials section.
`X-Bazaarvoice-Signature`	An access signature used to verify the request. This is created by the DCE user for each request. Refer to Creating the access signature for additional details.
`X-Bazaarvoice-Timestamp`	\n A Unix timestamp in milliseconds. DCE requests will be valid for 3600 seconds after the time stamp is created. Requests using an expired timestamp will return an error. \n

" } [/block] ## Access signature The contents of the message to be encrypted will vary based on the DCE request. The two possible variations are demonstrated below: [block:html] { "html": "\n \n \n \n \n \n \n \n \n

Without path	`passkey={DCE_PASSKEY}&timestamp={TIMESTAMP}`
With path	`path={PATH_VALUE}&passkey={DCE_PASSKEY}&timestamp={TIMESTAMP}`

" } [/block] The tokens above should be replaced with the appropriate values as described below: [block:html] { "html": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Name Description

Name	Description
`{PATH_VALUE}`	This is the same value communicated in the path query string parameter. Refer to the Workflow Walk-Through for more information.
`{DCE_PASSKEY}`	This is the same value communicated with the `X-Bazaarvoice-Passkey` header.
`{TIMESTAMP}`	\n A Unix timestamp in milliseconds. This is the same value communicated by the `X-Bazaarvoice-Timestamp` header. \n ⚠ Using seconds or any increment other than milliseconds will cause your request to fail \n

{PATH_VALUE}

This is the same value communicated in the path query string parameter. Refer to the Workflow Walk-Through for more information.

{DCE_PASSKEY}

This is the same value communicated with the X-Bazaarvoice-Passkey header.

{TIMESTAMP}

A Unix timestamp in milliseconds. This is the same value communicated by the X-Bazaarvoice-Timestamp header.

⚠ Using seconds or any increment other than milliseconds will cause your request to fail

" } [/block] Refer to [Creating Access Signature](/v1.0-DCE/docs/creating-access-signature) for verification values and code examples. ## Parameters [block:html] { "html": "\n \n \n \n \n \n \n \n \n \n \n \n \n

Name Description

Name	Description
`path`	\n The value identifying the DCE data set version in the form of a URL path segment. \n ⚠ The path value is provided by the DCE and must be used exactly as it is. Any modification will result in the DCE returning an error. \n

path

The value identifying the DCE data set version in the form of a URL path segment.

⚠ The path value is provided by the DCE and must be used exactly as it is. Any modification will result in the DCE returning an error.

" } [/block] ## Examples ### Request manifest file list Returns a JSON list of manifest file paths which will be used in the next request. Refer to the [tutorial](request-manifest-file-list) for detailed instructions. #### Request ```http GET https://[stg.]api.bazaarvoice.com/dce/v3/data ``` #### Headers ```http Host: [stg.]api.bazaarvoice.com X-Bazaarvoice-Passkey: {DCE_PASSKEY} X-Bazaarvoice-Signature: {SIGNATURE} X-Bazaarvoice-Timestamp: {TIMESTAMP} ``` ### Request manifest file Returns a 302 redirect to a manifest file containing paths to UGC data files. Refer to the [tutorial](request-manifest-file-location) for detailed instructions. #### Request ```http GET https://[stg.]api.bazaarvoice.com/dce/v3/data?path={MANIFEST_PATH} ``` #### Headers ```http Host: [stg.]api.bazaarvoice.com X-Bazaarvoice-Passkey: {DCE_PASSKEY} X-Bazaarvoice-Signature: {SIGNATURE} X-Bazaarvoice-Timestamp: {TIMESTAMP} ``` ### Request UGC data file Returns a 302 redirect to a file containing UGC data. Refer to the [tutorial](/v1.0-DCE/docs/request-ugc-data-file-location) for detailed instructions. #### Request ```http GET https://[stg.]api.bazaarvoice.com/dce/v3/data?path={UGC_DATA_PATH} ``` #### Headers ```http Host: [stg.]api.bazaarvoice.com X-Bazaarvoice-Passkey: {DCE_PASSKEY} X-Bazaarvoice-Signature: {SIGNATURE} X-Bazaarvoice-Timestamp: {TIMESTAMP} ``` ### Following a 302 redirect The DCE will return 302 redirects for some requests. This allows us to decouple the location of the data file from the DCE service path. It is essential that your application immediately follow the redirect exactly as it is provided and to not save or reuse redirects at a later time. ```http GET {REDIRECT_URL} ``` Refer to the [tutorial](/v1.0-DCE/docs/follow-302-redirect-to-ugc-data-file) for detailed instructions. ## Error specific troubleshooting tips Please see the [Troubleshooting page](troubleshooting).