Skip to content

Latest commit

 

History

History
346 lines (259 loc) · 3.53 KB

get-new-id-response.md

File metadata and controls

346 lines (259 loc) · 3.53 KB

GET /v1/new-id response

Property Type Description
sender string

The domain name of the sender of this response (the operator domain name)

Examples:

"a-domain-name.com"
"another.domain.co.uk"
receiver string

The domain name of the receiver of this request (the website)

Examples:

"a-domain-name.com"
"another.domain.co.uk"
timestamp integer

Number of seconds since UNIX Epoch time (1970/01/01 00:00:00)

Example:

1643297316
signature string

Signature based on input:

sender + '\u2063' +
receiver + '\u2063' +
timestamp + '\u2063' +
identifiers[0].source.signature

(there must be only one identifier)

Example:

"RYGHYsBUEwMgFgOJ9aUQl7ywl4xnqdmwWIgPbaIowbXbmZAFKLa7mcBJQuWh1wEskpu57SHn2mmCF6V5+cESgw=="
body object
Object details
Property Type Description
identifiers array

Type of each element in the array:

A pseudonymous identifier generated for a web user

Object details
Property Type Description
version string

A version number made of a "major" and a "minor" version numbers.

To be detailed.

Examples:

"0.1"
"0.407"
"10.0"
type enum (of string)

The identifier type, identifier of type paf_browser_id is mandatory and is "pivot"

Can only take one of these values:

  • "paf_browser_id"
persisted
(optional)
boolean

If set to false, means the identifier has not yet been persisted as a cookie.
Otherwise, means this identifier is persisted as a PAF cookie
(default value = true meaning if the property is omitted the identifier is persisted)

value string

The identifier value

Example:

"7435313e-caee-4889-8ad7-0acd0114ae3c"
source object

Signature based on input:

identifier.source.timestamp + '\u2063' + 
identifier.type + '\u2063'+
identifier.value
Object details
Property Type Description
timestamp integer

Time when data was signed

Example:

1643297316
domain string

The domain name of the entity that signed this data

Examples:

"a-domain-name.com"
"another.domain.co.uk"
signature string

The base64 representation of a data signature

Example:

"RYGHYsBUEwMgFgOJ9aUQl7ywl4xnqdmwWIgPbaIowbXbmZAFKLa7mcBJQuWh1wEskpu57SHn2mmCF6V5+cESgw=="