v1.1.0

HealthCheck.make()

Method for checking the availability of Bitrix24 REST API. Performs a simple request to the REST API to verify service health.
We are still updating this page. Some data may be missing here — we will complete it shortly.

Overview

Use HealthCheck.make() to check the availability of Bitrix24 REST API. The method returns a Promise with a boolean value indicating API availability.

// Basic usage
const isHealthy = await $b24.tools.healthCheck.make()

if (isHealthy) {
  console.log('Bitrix24 API is available')
} else {
  console.error('Problems accessing Bitrix24 API')
}

Method Signature

make(
  options?: { requestId?: string }
): Promise<boolean>

Parameters

ParameterTypeRequiredDescription
requestIdstringNoUnique request identifier for tracking. Used for request deduplication and debugging.

Return Value

Promise<boolean> — a promise that resolves to a boolean value:

  • true — REST API is available and responding, webhook is configured correctly.
  • false — REST API is unavailable, an error occurred, or necessary access rights are missing.

Examples

Availability check

Alternatives and Recommendations

  • For measuring response speed: Use Ping.
  • For checking specific permissions: Perform a test request to the required API method.
  • On the client-side (browser): Use the built-in B24Frame object.