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.

Environments and base URLs

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.

Authentication

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

Error codes

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