wagoe.audience.shell.http — com.wagoe/wagoe-audience 1.1.0-rc-1

HTTP handlers and route definitions for audience management.

Web Pages (mounted under /web/audiences): GET /audiences — list all segments GET /audiences/builder — new segment form GET /audiences/builder/:id — edit existing segment POST /audiences — create from the builder form POST /audiences/builder/:id — update from the builder form

API Endpoints (mounted under /api/audiences): POST /audiences — create audience PUT /audiences/:id — update audience DELETE /audiences/:id — delete audience POST /audiences/preview — returns count + sample POST /audiences/:id/evaluate — trigger evaluation GET /audiences/:id/members — list members

JSON keys are camelCase (cacheConfig), converted to kebab-case here.

audience-api-routes clj

(audience-api-routes resolver store)

(audience-api-routes resolver store middleware)

(audience-api-routes resolver store middleware {:keys [filter-fields]})

Reitit route data for the audience API. Mounted under /api/v1.

Args: resolver - IAudienceResolver store - IAudienceRepository middleware - route middleware every endpoint is wrapped in (authorization) opts - {:filter-fields #{...}}, the fields a filter may name

audience-web-routes clj

(audience-web-routes resolver store)

(audience-web-routes resolver store middleware)

(audience-web-routes resolver store middleware {:keys [filter-fields]})

Reitit route data for the audience web pages. Mounted under /web.

Args: resolver - IAudienceResolver store - IAudienceRepository middleware - route middleware every page is wrapped in (authorization) opts - {:filter-fields #{...}}, the fields a filter may name

builder-edit-handler clj

(builder-edit-handler _resolver store request)

GET /web/audiences/builder/:id — edit existing segment.

builder-page-handler clj

(builder-page-handler _resolver _store request)

GET /web/audiences/builder — new segment form.

create-audience-form-handler clj

(create-audience-form-handler _resolver store request & [filter-fields])

POST /web/audiences — create from the builder form.

create-audience-handler clj

(create-audience-handler _resolver store request & [filter-fields])

POST /api/audiences — create a new audience definition; 409 when its id is taken. filter-fields are the fields a filter may name, filter/default-filter-fields when nil.

delete-audience-handler clj

(delete-audience-handler _resolver store request)

DELETE /api/audiences/:id — delete an audience definition.

evaluate-audience-handler clj

(evaluate-audience-handler resolver _store request)

POST /api/audiences/:id/evaluate — trigger full evaluation and cache.

list-audiences-handler clj

(list-audiences-handler _resolver store _request)

GET /web/audiences — lists all segments.

list-members-handler clj

(list-members-handler resolver _store request)

GET /api/audiences/:id/members — list member user-ids for an audience.

preview-audience-handler clj

(preview-audience-handler resolver _store request)

POST /api/audiences/preview — resolve the audience named by audienceId and return count + sample.

update-audience-form-handler clj

(update-audience-form-handler _resolver store request & [filter-fields])

POST /web/audiences/builder/:id — update from the builder form. What the form has no field for — cache config and tags — is kept.

update-audience-handler clj

(update-audience-handler _resolver store request & [filter-fields])

PUT /api/audiences/:id — replace an audience definition; 404 when none is stored. See create-audience-handler for filter-fields.