Request

Path

GET https://[stg.]api.bazaarvoice.com/dce/v3/data?path={MANIFEST_PATH}

Path tokens

Name Description

Name	Description
`[stg.]`	Optional subdomain indicating the request should use the non-production environment. Omit to use production. Learn more at the Reference section.
`{MANIFEST_PATH}`	This is a file path acquired from the previous step. ⚠ The file path must be used exactly as it is. Any modification will result in the DCE returning an error.

[stg.]

Optional subdomain indicating the request should use the non-production environment. Omit to use production. Learn more at the Reference section.

{MANIFEST_PATH}

This is a file path acquired from the previous step.

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

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 following string, encrypted using the algorithm described at Creating the Access signature.

path={MANIFEST_PATH}&passkey={DCE_PASSKEY}&timestamp={TIMESTAMP}

Replace the tokens above with the appropriate values as described below:

Name Description

Name	Description
`{MANIFEST_PATH}`	This is a file path acquired from the previous step. This is the same value communicated in the `path` query string parameter.
`{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

{MANIFEST_PATH}

This is a file path acquired from the previous step. This is the same value communicated in the path query string parameter.

{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

Response

Response will be a HTTP 302 redirect to the location of the manifest file. The response will also include the location path value in the body of the request as a convenience for applications that cannot be configured to follow the redirect automatically. The following demonstrates a typical response:

HTTP/1.1 302 Found  
Content-Type: application/json  
Location: {MANIFEST_URL}

{"location":"{MANIFEST_URL}"}

Some headers have been removed for clarity.

The next step will describe how your application can use the location path value to request a manifest file.