Testing

A test key returns the same shapes against a fixed fixture set. It is free, deterministic and safe to run in CI on every commit.

Deterministic fixtures

Test-mode products have stable identifiers and stable histories, so a snapshot test written today still passes next month. Live data cannot give you that.

Force error paths

The failure branches are the ones that break in production and the ones nobody exercises. Trigger them on demand.

HTTP

GET /v1/products/prd_test_rate_limited   → 429
GET /v1/products/prd_test_source_down    → 503
POST /v1/resolve {"ref":"__ambiguous__"} → 422 match_below_threshold

Webhooks locally

The CLI signs test deliveries with your endpoint secret, so your verification code is exercised rather than bypassed. Verification bugs found in production are always signature bugs nobody tested.

Terminal

npx @commercecensus/cli listen --forward http://localhost:3000/hooks
npx @commercecensus/cli trigger price.changed --product prd_test_1

Previous← SDKs and clients NextIdentifiers →