Adworth℠ — Developer API

// Before accessing user data, verify consent

const response = await fetch('https://adworth-bouncer.adworthllc.workers.dev/evaluate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    userId:       'user-abc-123',
    advertiserId: 'nike-ads',
    dataScope:    'running-data-shoe-ads'
  })
});

const decision = await response.json();

if (decision.decision === 'GRANTED') {
  // ✅ Valid consent — proceed with data access
  accessUserData(decision.token_id);
} else {
  // 🚫 No consent — do NOT access data
  console.log('Blocked:', decision.reason_description);
}

// User has valid, active consent for this scope
{
  "decision":    "GRANTED",
  "decision_id": "gov_a1b2c3d4-...",
  "token_id":    "bf5e15a558b04546-...",
  "details": {
    "token_scope":      "running-data-shoe-ads",
    "token_advertiser": "nike-ads",
    "expires_at":       "2026-04-01T00:00:00Z",
    "remaining":        "29d"
  },
  "checks_performed": [
    "token_exists", "token_not_revoked",
    "token_not_expired", "advertiser_match",
    "scope_match", "ledger_revocation_check"
  ]
}

// No valid consent — do NOT access this user's data
{
  "decision":            "BLOCKED",
  "reason":              "SCOPE_MISMATCH",
  "reason_description":  "Requested data scope is not covered by the consent token",
  "details": {
    "token_scope":    "running-data-shoe-ads",
    "requested_scope": "health-insurance-data"
  }
}