Core Concepts

This page orients you to the cross-cutting rules that apply to every Bead API. Each topic has its own detail page; the summaries below tell you when to click through.

Sandbox and production hosts, ports, TLS requirements, health-check endpoints, and how to switch between environments without code changes. See “Environments & Base URLs” for the full table.

OAuth 2 client-credentials flow, token scopes, token expiry, and how to rotate credentials safely. See “Authentication” for sample cURL and common errors.

Standard JSON error object, mapping of HTTP status codes to fault categories, and the retry / no-retry decision tree. See “Error Codes” for examples.

Last updated