Appearance

These endpoints are called from a shopper's browser, so they take your publishable key rather than a secret one. Anything specific to one customer also takes a signed email and timestamp: see Identifying the customer for how to produce the signature.

GET `/widgets/theme.css`

Get the stylesheet that themes the widgets on one site. The embed script links this before it renders anything, so the widgets never paint with the default colors first. Cache it for as long as the URL says: the version in the URL changes whenever the appearance does.

Query Parameters

apiPublishableKeystringrequired

Your organization's publishable key, from Settings, API keys.

sitestring

The slug of the site whose appearance to serve, from data-cascade-site on your script tag. With no site named, the organization's oldest site is used, which is the right answer for the single-site majority.

vstring

The version from the stylesheet URL Cascade gives you. It only busts the cache: the current appearance is served whatever you send.

Request

curl \
  "https://api.cascade.dev/widgets/theme.css?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY"

Request

import { client } from "@cascade-commerce/api/widget/client"
import { getWidgetsThemeCss } from "@cascade-commerce/api/widget"

client.setConfig({
  baseUrl: "https://api.cascade.dev",
})

const { data, error } = await getWidgetsThemeCss({
  query: { apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY" },
})

Request

require "net/http"

uri = URI("https://api.cascade.dev/widgets/theme.css?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY")
req = Net::HTTP::Get.new(uri)

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

Request

import json
from urllib.request import Request, urlopen

req = Request(
    "https://api.cascade.dev/widgets/theme.css?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY",
)
with urlopen(req) as res:
    print(json.load(res))

#Appearance

GET /widgets/theme.css

Query Parameters

Appearance

GET `/widgets/theme.css`