Record entries as shown

POST

/v1/changelog/widget/seen

Call when the widget shows entries (opened list, announcement). Every id the person may see counts one view; others are ignored. With a verified user id, each entry gets a read row (entry, user id, first time) the first time: that is the read state, the once-per-person announcement, the signed-in reader count and “after reading”. Anonymous: nothing about the browser is stored; ids in first_time_ids move the anonymous-readers counter. Up to 50 ids.

Auth: Publishable key from the browser, or a secret key. To act as a signed-in person send user_id and user_hash = HMAC-SHA256(signing secret, user_id) as lowercase hex (the same signing secret as the notification bell; header X-Nordva-User-Hash, or user_hash in the query or body). A user_id with a missing or wrong hash answers USER_HASH_INVALID (403); it is never quietly treated as anonymous. A secret key may name any user_id without a hash, to preview what that person sees. client_id is the widget’s random id for one browser (16 to 64 letters, digits, - or _) and is used only for reactions.

Rate limits: browser calls count against 120 requests a minute per IP address, not the key’s budget.

CORS: Access-Control-Allow-Origin: *.

Authorizations

• PublishableApiKey
• SecretApiKey

Request Body ^required

object

entry_ids

required

Array<string>

>= 1 items <= 50 items

first_time_ids

Anonymous only: the ids this browser had not shown before, from its own storage. Each moves the anonymous-readers counter by one.

Array<string>

<= 50 items

user_id

string

<= 256 characters

user_hash

string

client_id

string

/^[A-Za-z0-9_-]{16,64}$/

Responses

200

Recorded

object

data

object

recorded

integer

unseen_count

integer | null

error

null

meta

object

400

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

401

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

403

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

404

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties