Install in three lines. Audit-ready in five minutes.

01 · Quickstart

Three lines of HTML.

Issue an app key in the dashboard, paste this into the head of your site, and you’re live. Events stream into the dashboard in real time.

<script
  src="https://articleproof.app/widget.v1.js"
  data-app-key="ps_live_xxxxxxxxxxxxxxxxxxxxxx"
  defer
></script>

Use a ps_test_* key in development. Promote to ps_live_*when you’re ready to count it against your event quota.

02 · Event shape

What a disclosure event looks like.

The widget POSTs to /api/events with the app key in the Authorization header and the Origin header set by the browser. Each event becomes a row in the disclosure-events table — tenants can read their events but have no edit or delete path. Integrity hashes are computed over the canonicalised event set when you export an audit pack.

POST https://articleproof.app/api/events
Authorization: Bearer ps_live_xxxxxxxxxxxxxxxxxxxxxx
Origin: https://your-app.com
Content-Type: application/json

{
  "type": "render",
  "sessionId": "sess_h7Qm3Vpn2Bk",
  "pageUrl": "https://your-app.com/chat",
  "aiModel": "gpt-4o",
  "provider": "openai",
  "jurisdiction": "eu"
}

Event types: render, ack, dismiss, synthetic_output, deepfake_label. The widget emits the first three automatically; you call window.articleProof.log(...) for the latter two.

Reference

Topics.