Get a microsnippet response

1 min

GET

https://optimizely-edge.com/edge-client/v1/{accountId}/{projectId}

Call the Edge Decider API to fetch a microsnippet. Given the required arguments, the Edge Decider will bucket visitors into variations of active experiments they're qualified for and return the JavaScript microsnippet. The microsnippet is executed by the browser to apply the variations' changes.

Note that for security, the Edge Decider API only supports connections made over HTTPS. It does not support connections made over insecure HTTP and responds with a 403 status instead.

accountIdstringOptimizely Account ID

projectIdstringProject ID of the Performance Edge project.

extend_cookie_lifetimestringWhether or not the snippet should extend cookies. Defaults to true. Only has an effect on cookies which are already set, according to the Cookie header value. If it has not been set before, the cookie is set regardless of this parameter value. Currently, this only affects the "OptimizelyEndUserId" cookie.

urlstringDocument URL requested, which is used to determine the active pages(s)/experiment(s) Needs to be passed encoded.

CookiestringCookies set on the requested domain. For cookie targeting, userId derivation, bucketing. Include any cookies that your users may want to use to define visitor audiences. At a minimum, must include the value of the optimizelyEndUserId cookie, if set. If unset, the JavaScript response will instruct the browser to set that cookie on the user’s device. NOTE Please review our <a href="https://help.optimizely.com/Account_Settings/PII%3A_Personally_identifiable_information_in_Optimizely" target="_blank">guidance on usage of PII</a> with Optimizely Products.

RefererstringDocument URL requested, which is used to determine the active pages(s)/experiment(s), if the “url” query parameter is not specified. In typical implementations, the Referer header in the script request will equal the URL of the page on which the script was loaded.

User-AgentstringUser Agent used to make the request. Optimizely Edge will only serve the JavaScript response to browsers that are detected as having support for it, using this value. Also used for browser, device, platform targeting (<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent" target="_blank">Reference</a>)

X-Forwarded-ForstringA comma-separated list of IP addresses, the first of which will be used as the basis for IP Address and Location experiment targeting. (<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For" target="_blank">Reference</a>)

200Successful response supplies JavaScript code for microsnippet

403Request made not using HTTPS

405Invalid input

curl --request GET \
     --url https://optimizely-edge.com/edge-client/v1/{accountId}/{projectId} \
     --header 'accept: application/json' \
     --cookie string \
     --header 'referer: string' \
     --header 'user-agent: string' \
     --header 'x-forwarded-for: string'