---
title: "Получить время в разделах маркетплейсов"
method: GET
path: "/api/v1/marketplace/usage"
tags: ["Marketplace usage"]
---

# Получить время в разделах маркетплейсов

`GET /api/v1/marketplace/usage`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marketplace/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Сколько времени кабинет провёл в каждом разделе каждой площадки за
окно и сколько раз его открывал — по кабинету в целом, без разбивки
по сотрудникам. share_pct — доля времени раздела среди всех разделов
этой площадки (сумма по площадке — 100). Из этого строятся порядок и
доля на плитках листа «Площадки»; та же сводка показывает, какими
разделами пользуются, а какими нет.

## Query parameters

- `days` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Время в разделах за окно

- MarketplaceSectionUsageList: Время в разделах кабинета за окно
  - `days` integer, required: Окно в днях
  - `count` integer, required: Сколько строк «площадка × раздел»
  - `results` MarketplaceSectionUsage[], required
    - `platform` string, required: Площадка — ключ экрана
    - `section` string, required: Раздел модуля — ключ меню
    - `seconds` integer, required: Секунды в разделе за окно
    - `opens` integer, required: Сколько раз раздел открывали за окно
    - `share_pct` number, double, required: Доля времени раздела среди разделов этой площадки, %
    - `last_active_at` string, date-time, required: Последняя отметка

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `500`: Внутренняя ошибка без раскрытия server-only деталей

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)