tasks.task.counters.get
Получить счетчики пользователя
Описание
Метод tasks.task.counters.get получает значения счетчиков задач для указанного пользователя.
Параметры
userId
integer
необязательный
Идентификатор пользователя, для которого нужно получить счетчики.
По умолчанию используется текущий пользователь.
Идентификатор пользователя можно получить методом получения списка пользователей
groupId
integer
необязательный
Идентификатор группы, для задач которой нужно получилось счетчики.
Передайте 0 или не указывайте параметр, чтобы учитывать все группы.
Получить идентификатор можно методом создания новой группы или методом получения списка групп.
type
string
необязательный
Роль, для которой нужно получить счетчики. Возможные роли:
- view_all — все роли
- view_role_responsible — делаю
- view_role_accomplice — помогаю
- view_role_auditor — наблюдаю
- view_role_originator — поручил
По умолчанию используется роль view_all
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"userId":547,"groupId":0,"type":"view_all"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.counters.get
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"userId":547,"groupId":0,"type":"view_all","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/tasks.task.counters.get
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type CounterInfo = {
counter: number
code: number
}
// Shape of the payload returned in result (match the "response handling" section of the page)
type CountersGetResult = {
expired?: CounterInfo
new_comments?: CounterInfo
}
try {
const response = await $b24.actions.v2.call.make<CountersGetResult>({
method: 'tasks.task.counters.get',
params: {
userId: 547,
groupId: 0,
type: 'view_all',
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Task counters:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function getTaskCounters() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'tasks.task.counters.get',
params: {
userId: 547,
groupId: 0,
type: 'view_all',
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Task counters:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', getTaskCounters)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.tasks.task.counters.get(
user_id=547,
group_id=0,
type="view_all",
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'tasks.task.counters.get',
[
'userId' => 547,
'groupId' => 0,
'type' => 'view_all'
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error fetching task counters: ' . $e->getMessage();
}
BX24.callMethod(
'tasks.task.counters.get',
{
userId: 547,
groupId: 0,
type: 'view_all'
},
function(result){
console.info(result.data());
console.log(result);
}
);
require_once('crest.php');
$result = CRest::call(
'tasks.task.counters.get',
[
'userId' => 547,
'groupId' => 0,
'type' => 'view_all'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "tasks.task.counters.get", b24.Params{
"userId": 547,
"groupId": 0,
"type": "view_all",
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("tasks.task.counters.get: %w", err)
}
keys, ok := b24.Keys(res.Result)
if !ok {
return fmt.Errorf("ожидался объект в ответе")
}
fmt.Println("полей в ответе:", len(keys))
Ответ
HTTP-статус: 200
{
"result": {
"expired": {
"counter": 1,
"code": 6291456
},
"new_comments": {
"counter": 7,
"code": 12582912
}
},
"total": 1,
"time": {
"start": 1758868152,
"finish": 1758868152.929809,
"duration": 0.9298090934753418,
"processing": 0,
"date_start": "2025-09-26T09:29:12+03:00",
"date_finish": "2025-09-26T09:29:12+03:00",
"operating_reset_at": 1758868752,
"operating": 0
}
}
Возвращаемые данные
result
object
Объект, в котором ключ — название счетчика, а значение — объект с описанием счетчика.
Значения счетчиков:
- new_comments — непрочитанные комментарии
- expired — просроченные задачи
Возвращает пустой массив "result":[], если пользователь не существует или нет прав на получение счетчиков указанного пользователя
total
integer
На текущий момент не используется. Всегда возвращает значение 1
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "0",
"error_description": "Group not found or access denied. (internal error)"
}
| Код | Описание | Значение |
|---|---|---|
0 |
Invalid value {value} to match with parameter {userId}. Should be value of type int. | В параметре userId указано значение неверного типа |
0 |
Group not found or access denied. (internal error) | Группа не существует или к ней нет прав доступа |

