API reference Alerts

Get alerts on this browser

POST/v1/push/subscriptions

Stores the browser's push subscription: agent requests, blocked carts and stops are pushed to it.

Headers

Content-Typeapplication/jsonRequired
idempotency-keystringRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Request body

application/json

endpointstringRequired
expirationTimenumber
keysobjectRequired

Responses

201Subscribed
401Not signed in

201 response

idstringRequired

curl -X POST https://api.keelson.finance/v1/push/subscriptions \
  -H 'content-type: application/json' \
  -H 'idempotency-key: <idempotency-key>' \
  -H "idempotency-key: $(uuidgen)" \
  --data '{"endpoint":"string","expirationTime":0,"keys":{"p256dh":"string","auth":"string"}}'

const res = await fetch("https://api.keelson.finance/v1/push/subscriptions", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "idempotency-key": "<idempotency-key>",
    "idempotency-key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "endpoint": "string",
    "expirationTime": 0,
    "keys": {
      "p256dh": "string",
      "auth": "string"
    }
  }),
});
const data = await res.json();

Response · shape from the schema

{
  "id": "string"
}