admin-components

Search and page through the component catalogue

One page of components (with expand: brand), enriched with brand name and colour, 30-day human click counts and affiliate link counts.

  • totalItems and totalPages count the PocketBase filter result before the hasAffiliate post-filter; hasAffiliate and the clicks30d sorts act on the loaded page only.
  • affiliateLinkCount is only filled when hasAffiliate or a clicks30d sort is set; otherwise it is 0.
  • clicks30d counts component_click_events of the last 30 days, skipping bot user agents.
get/api/admin/components/list

Request

  • Base URL: https://voltplan.app
  • URL: https://voltplan.app/api/admin/components/list
  • Auth: HTTP bearer

Query parameters

pageinteger
perPageinteger

Values above 200 are capped to 200.

searchstring

Substring of name (PocketBase ~).

typestring

Exact component type.

brandstring

Id of the component_brands record (not the brand name).

missing'watt' | 'price' | 'image'

Only components without watt, price or image (null/0/""). Other values are ignored.

hasAffiliate'yes' | 'no'

Only components with (yes) or without (no) affiliate links, applied to the loaded page.

published'yes' | 'no'

yes = published; no = false or never set.

sortstring
Example:name

PocketBase sort expression, passed through unchanged. clicks30d / -clicks30d sort the loaded page by 30-day clicks (PocketBase then sorts by -updated).

Response

One page of components.

pageinteger required
perPageinteger required
totalItemsinteger required

Matches of the PocketBase filter, before hasAffiliate.

totalPagesinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.