Skip to main content
Before you start with widgets or the calculators API, make sure you have the following.

Your key

CBS uses a single key for both integration paths:
  • Widgets: pass the key in the script tag’s src:
  • Calculators API: send the same value in the pcc-api-key request header:
It’s one credential: the widget reads the key from its own script tag and forwards it to the API as pcc-api-key. To request a key or retrieve an existing one, contact your Symmetry Client Success representative or reach out through the Client Support Center.

Supported browsers (widgets)

CBS widgets run in current versions of the major browsers (Chrome, Edge, Firefox, Safari). Internet Explorer is not supported: the widget shows an unsupported-browser message instead of loading.
There is no formal minimum-version matrix; any modern, evergreen browser works.

Hosting

  • Widgets: must load from a web server over http(s)://, not opened directly from the local file system (file://). A widget reads its host from its own script URL, so it needs a live page URL to render.
  • Calculators API: always accessed over HTTPS.

Key limits and restrictions

  • Domain restriction: a key can be limited to specific domains, so it only works on sites you control. See Authentication model.
  • Trial key cap: trial keys have a calculation limit. Once it’s reached, the API returns a 401 error (“API rate limit has been exceeded”). See Rate limits.

Next

Quickstart: Embed a widget

Add a calculator to a page with one script tag.

Quickstart: Call the calculators API

Authenticate and run your first calculation.