Widget API

5 endpoints.

Method	Path	Summary
`GET`	`/api/widget/analytics/{slug}`	Get widget analytics for a community
`GET`	`/api/widget/config/{slug}`	Get community public configuration for widgets
`POST`	`/api/widget/track`	Track widget events (loads and clicks)
`GET`	`/sdk/v1/widget.js`	Serve versioned widget SDK script (v1)
`GET`	`/sdk/widget.js`	Serve the latest widget SDK script

GET /api/widget/analytics/{slug}

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`slug`	path	yes	string	—
`days`	query	no	integer	—

Responses

Status	Description	Body
`200`	Widget analytics	—

GET /api/widget/config/{slug}

Auth: Bearer JWT required.

Parameters

Name	In	Required	Type	Description
`slug`	path	yes	string	—

Responses

Status	Description	Body
`200`	Community configuration	object

POST /api/widget/track

Auth: Bearer JWT required.

Request body (required) — application/json

Field	Type	Required	Description
`communitySlug`	string	yes	—
`eventType`	enum: `load`, `click`	yes	—
`referrer`	string	no	—
`metadata`	object	no	—

Responses

Status	Description	Body
`200`	Event tracked successfully	—

GET /sdk/v1/widget.js

Auth: Bearer JWT required.

Responses

Status	Description	Body
`200`	Widget SDK script v1	string

GET /sdk/widget.js

Auth: Bearer JWT required.

Responses

Status	Description	Body
`200`	Widget SDK script	string