API Reference

Core endpoints used by the Player SDK and dashboards.

Serve: decidePOST

POST /api/serve/decide
{
  "placement": "enoplayer_default",
  "slot": "preroll|midroll|postroll|sponsored",
  "plan": "free|ad_supported|standard|premium",
  "region": "UG|CA|EU",
  "userKey": "user_123",
  "sessionId": "sess_abc",
  "positionSec": 600,
  "consent": { "necessary":true, "functionality":true, "targeting":false }
}

Response returns the selected ad + rules + reason.

Report: eventPOST

POST /api/report/event
{
  "adId": "ad_...",
  "event": "impression|start|skip|complete|click",
  "slot": "preroll|midroll|postroll|sponsored",
  "placementId": "enoplayer_default",
  "userKey": "user_123",
  "sessionId": "sess_abc",
  "plan": "ad_supported",
  "region": "CA",
  "positionSec": 600,
  "meta": { "url":"https://..." }
}

Auth: loginPOST

POST /api/auth/login
{ "email":"admin@...", "password":"..." }