Native Bridge Contract

Use this contract to connect Unity/OpenXR headset apps to WeAD XR reward infrastructure securely.

Provisioning

  • Admin creates native device credentials via POST /api/xr/admin/native-devices.
  • Use returned x-api-key in native client request headers.

Native Endpoints

  • POST /api/xr/native/heartbeat
  • POST /api/xr/native/session/start
  • POST /api/xr/native/telemetry
  • POST /api/xr/native/session/end

Telemetry Event Model

  • Required: sessionId, events[].
  • Event fields: interactionType, placementId, dwellMs, confidence, idempotencyKey.
  • Server normalizes interaction aliases and computes deterministic rewards.