v2.1.0

API Reference

Index of the public @bitrix24/b24jssdk surface, grouped by domain — every value export, what it is, and where its guide and source live.

This is the index of every value @bitrix24/b24jssdk exports publicly — the classes, enums, constants and functions you can import and use at runtime — grouped by domain. Each entry says what the export is and links to its guide and its source. Pure type and interface exports are not listed here; they have their own page, the Types overview.

It deliberately does not restate signatures and parameter tables: those live in the guides, where they are audited against the source and their snippets are compiled in CI. This page is the map, not the territory. Per-symbol reference pages are a separate, later layer — tracked in #315.

New here? Start with Get Started and pick an entry point below — that choice determines everything else.

Entry points

Pick by where your code runs — this is the first decision, and everything else follows from it.

ExportWhat it isGuide
B24HookServer-side webhook auth. Carries a long-lived secret — never ship it to a browser.guide
B24FrameAn app running inside a Bitrix24 placement iframe.guide
initializeB24FrameThe only correct way to construct a B24Frame — performs the parent handshake.guide
B24OAuthA marketplace/OAuth app, authenticated per portal with a refresh token. Server-side only, like B24Hook — never ship the client secret to a browser.guide
AbstractB24The shared base the three entry points extend — where the deprecated b24.callMethod()-style shortcuts live.guide
AuthHookManagerAuth actions behind B24Hook.guide
AuthOAuthManagerAuth actions behind B24OAuth, including token refresh.guide

Actions — calling the REST API

The $b24.actions.v{2,3}.* surface. v2 and v3 are different dialects, not versions of one thing.

ExportWhat it isGuide
versionManagerRoutes a method to the v2 or v3 transport.
ApiVersionThe restApi:v2 / restApi:v3 discriminator.guide
HttpV2The v2 transport.guide
HttpV3The v3 transport.guide
FilterV3Typed builder for the v3 array-of-triples filter grammar.guide
BatchRefV3$ref / $refArray markers for v3 batch cross-command substitution.guide

Results and errors

Every call returns a Result; failures split into soft (returned) and hard (thrown).

ExportWhat it isGuide
AjaxResultThe response wrapper — isSuccess, getData(), getErrorMessages().guide
ResultThe base result type.guide
AjaxErrorA transport-level error, with credentials redacted from requestInfo.guide
SdkErrorAn SDK error carrying a stable code to discriminate on.guide

Rate limiting

The limiter stack that keeps the SDK inside the portal's request budget.

ExportWhat it isGuide
RestrictionManagerOwns the limiter stack and the retry policy.guide
ParamsFactoryPreset limiter configurations (getDefault(), getBatchProcessing()).guide
RateLimiterRequest-rate limiter.guide
OperatingLimiterHonours the portal's operating budget.guide
AdaptiveDelayerBackoff between retries.guide

Realtime — Pull

Push notifications from the portal.

ExportWhat it isGuide
B24PullClientManagerThe Pull client.guide
PullStatusConnection status values.guide
SubscriptionTypeSubscription kinds.guide
ConnectionTypeTransport used by the client.guide
CloseReasonsWhy a connection closed.

Frame managers

Available on a B24Frame instance — the portal-side UI surface.

ExportWhat it isGuide
ParentManager$b24.parent — control the iframe inside the portal layout.guide
SliderManager$b24.slider — open paths and app pages in a slider.guide
PlacementManager$b24.placement — the context the user opened the app from.guide
DialogManager$b24.dialog — pick users, CRM entities, access targets.guide
OptionsManager$b24.options — persist app and per-user settings.guide
AuthManager$b24.auth — the frame's auth actions.guide
MessageManagerThe postMessage bridge to the parent window, reachable as $b24.parent.message.

Helper

Aggregated portal state — profile, app, licence, currency.

ExportWhat it isGuide
useB24HelperComposable that initialises and exposes the helper.guide
LoadDataTypeWhich data sets the helper loads.guide
EnumAppStatusApplication status values.guide
TypeSpecificUrlPortal URLs the helper resolves.guide
StatusDescriptionsHuman-readable app-status descriptions.guide
TypeOptionThe value-type discriminator $b24.options stores settings under.guide

Logging

Monolog-style logging. Logger.log() never throws and never rejects.

ExportWhat it isGuide
LoggerFactoryBuild a configured logger — start here.guide
LoggerThe logger implementation.guide
AbstractLoggerBase class implementing the level convenience methods.guide
NullLoggerNo-op logger; the SDK's default.guide
LogLevelSeverity levels, DEBUG through EMERGENCY.guide
ConsoleHandlerWrites to the browser console.guide
ConsoleV2HandlerImproved console handler.guide
MemoryHandlerKeeps records in memory — useful in tests.guide
StreamHandlerWrites to a Node stream.guide
TelegramHandlerSends records to a Telegram chat.guide
ConsolaAdapterBridges to Consola.guide
WinstonAdapterBridges to Winston.guide
LineFormatterFormats a record as a line.guide
JsonFormatterFormats a record as JSON.guide
TelegramFormatterFormats a record for Telegram HTML.guide
memoryUsageProcessorAdds memory usage to a record.guide
pidProcessorAdds the process id to a record.guide

Tools

Small utilities the SDK uses and re-exports.

ExportWhat it isGuide
TypeRuntime type guards.guide
TextString, id and date helpers.guide
BrowserBrowser and platform detection.guide
useFormatterNumber and date formatting.guide
EnvironmentWhere the code is running.guide
getEnvironmentResolve the current environment.guide
omitObject helper — drop keys.guide
pickObject helper — keep keys.guide
isArrayOfArrayArray shape guard.guide
getEnumValueEnum lookup helper.guide
B24LangListSupported portal languages.guide
B24LocaleMapLocale mapping.guide

Domain types

Typed shapes for the portal's own entities.

ExportWhat it isGuide
EnumCrmEntityTypeIdCRM entity type ids.guide
DataTypeGeneric data-type discriminator.guide
CatalogProductTypeCatalog product types.
ProductRowDiscountTypeIdDiscount types on a product row.
EnumBizprocDocumentTypeBusiness-process document types.
getDocumentTypeBuild a bizproc document type.
getDocumentIdBuild a bizproc document id.

Everything else

Also exported, and reachable from the groups above or from the guides — listed so this page stays a complete index of the public surface:

AppFrame CatalogProductImageType CatalogRoundingRuleType EnumBitrix24Edition EnumBizprocBaseType EnumCrmEntityType EnumCrmEntityTypeShort ListRpcError LoggerBrowser LoggerType LsKeys MessageCommands RefreshTokenError RpcMethod SenderType ServerMode SystemCommands convertBizprocDocumentTypeToCrmEntityTypeId getDocumentTypeForFilter getEnumCrmEntityTypeShort

Not yet covered by a guide

These exports are public but have no deep-dive page of their own yet. They are listed here rather than quietly omitted, so the gap is a visible, closable list instead of something a reader discovers by failing to find it:

AppFrame CatalogProductImageType CatalogProductType CatalogRoundingRuleType CloseReasons EnumBitrix24Edition EnumBizprocBaseType EnumBizprocDocumentType EnumCrmEntityType EnumCrmEntityTypeShort ListRpcError LoggerBrowser LoggerType LsKeys MessageCommands MessageManager ProductRowDiscountTypeId RpcMethod SenderType ServerMode SystemCommands convertBizprocDocumentTypeToCrmEntityTypeId getDocumentId getDocumentType getDocumentTypeForFilter getEnumCrmEntityTypeShort versionManager

Most are enums and type namespaces whose meaning is evident from the source linked above. If you needed one of these and the source was not enough, that is worth an issue — it tells us which page to write next.