Concepts
The model behind the API: workspaces, connection kinds, licences, scopes and failure handling.
The model behind the API: workspaces, connection kinds, licences, scopes and failure handling.
Workspaces
A key belongs to exactly one workspace. What that means for multi-tenant apps, and how a Bitrix24 portal differs from a standalone workspace.
Connection types
The provider field is qr or cloud_api. What each one can do, and where the two genuinely differ.
Licences & trial
A 7-day free trial per number, then a monthly licence per number. What a slot is, and what happens when one expires.
Scopes
Four scopes, resolved live on every request. Which endpoints need which, and why marking read is a send.
Errors & idempotency
Branch on the error code, not the status. And make every retry that costs money safe.