Track

Decodes a Base64-encoded tracking payload from the url query parameter, validates it against the hash and t (Unix epoch timestamp) parameters using a shared secret, records a click/impression event (if the request is valid and not from a web crawler), then issues a 301 Moved Permanently redirect to the original destination URL. Tracking is best-effort; the redirect always occurs regardless of tracking success. Authentication is not required.

Example request data

{
    "clientId": "CORTEX",
    "sourceSystem": "campaigns",
    "sourceSystemId": "2ee98a76-15de-535d-99d0-9761536863ae",
    "originalUrl": "https://www.cortextech.io/",
    "authId": 123456,
    "metadata": {
        "promoBlockName"  : "Test Campaign",
        "rulesetId" : "5ece7bc30a892d37b4c16a8e",
        "rulesetName" : "User must be from the Maldives",
        "promoBlockVersion" : 1
    }
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Base64-encoded JSON blob representing a TraceRequest object. Must include at minimum an originalUrl field.

string

Unix epoch timestamp of the request, used together with hash to validate the payload. Required for tracking to be recorded.

string

HMAC hash of the url and t parameters, signed with a shared private secret. Required for tracking to be recorded.

Headers
string

Real client IP address, typically forwarded by a reverse proxy.

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json