screen.calibrated

Screen calibration baseline established

Sent once when a Harvester completes calibration or recalibration for its screen and a new baseline takes effect. baseline holds the new reference for each channel, in the same units as reference on screen.quality. When recalibration is true, the screen already had a baseline, so re-evaluate anything you scored against the old one. calibratedAt matches the calibratedAt on later screen.quality events.

Delivery headers

POST /your/endpoint HTTP/1.1
Content-Type: application/json
X-Vojo-Signature: t=1761037200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

Example payload

{
  "eventType": "screen.calibrated",
  "attemptId": "att_7Hq3",
  "eventId": "evt_screen_calibrated_01",
  "screenId": "scr_123",
  "screenName": "Platform 2 north",
  "harvesterId": "hrv_123",
  "harvesterMacAddress": "A4:CF:12:3B:9E:01",
  "calibratedAt": "1761037200",
  "recalibration": true,
  "baseline": {
    "red": 420,
    "green": 500,
    "blue": 300,
    "white": 1200
  }
}

Payload

eventTypestringRequired
Always screen.calibrated
eventIdstringRequired
Stable per-event id, constant across retries (injected at delivery). Dedupe on this.
screenIdstringRequired
screenNamestringRequired
harvesterIdstringRequired
harvesterMacAddressstringRequired
calibratedAtstringRequired
Epoch (seconds) the new calibration baseline was taken. Equals the calibratedAt of subsequent screen.quality events.
recalibrationbooleanRequired
True when the screen already had a calibration baseline before this one — references on earlier screen.quality events are superseded.
baselineobjectRequired
The new per-channel calibration reference (clear-channel counts). Same units as reference on screen.quality. A channel is null only if the harvester reported it as non-numeric.
Show 4 fields
- rednumber or nullRequired
- greennumber or nullRequired
- bluenumber or nullRequired
- whitenumber or nullRequired
attemptIdstring
Per-attempt id; CHANGES on each retry. Do not dedupe on this.

Handling this event

Verify the signature, reply with a 2xx within 20 seconds, then process the event in the background. Retries reuse the same event id, so deduplicate on it.