iRetail PRO
English Получить ключ
Меню

iRetail PRO hub 1.0.0-m5: dashboards

4 операции

← Вся документация · Источник: контракты, openapi/hub-v1.yaml на коммите 8000474.

Справочники на английском — на языке контрактов, из которых они созданы.

Pages of tiles over the analytics (spec/DASHBOARDS.md).

← iRetail PRO hub 1.0.0-m5

Операции

GET /v1/dashboards The organization's dashboards and the ready-made set (spec/DASHBOARDS.md).

operationId listDashboards · Право report.read

Параметры

Имя Где Тип Описание
IRetail-App header string Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking).

Ответы

GET /v1/dashboards/{id} One dashboard.

operationId getDashboard · Право report.read

Параметры

Имя Где Тип Описание
id обязательный path string
IRetail-App header string Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking).

Ответы

PUT /v1/dashboards/{id} Save a dashboard; under a ready-made id, the organization's copy takes its place.

operationId putDashboard · Право dashboard.manage

Параметры

Имя Где Тип Описание
id обязательный path string
IRetail-App header string Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking).
If-Match header string The version the change is based on.

Тело запроса обязательный

Ответы

DELETE /v1/dashboards/{id} Delete the organization's dashboard (a ready-made one comes back in its place).

operationId deleteDashboard · Право dashboard.manage

Параметры

Имя Где Тип Описание
id обязательный path string
IRetail-App header string Which app sends the request, at which version: <app>/<version>, optionally a space and (<platform>), as cashier/1.2.0 (windows-x64) or manager/1.2.0 (web). The register (cashier), the back office and the console (manager) and the device gateway (gateway) send it on every request; a request without it is not one of the apps and is served as the current API, and a device token of an app's kind without it is an app of an unknown version; a header that does not parse counts as absent. The node may refuse an app 426 app_update_required by it, except on the operations marked x-app-update-exempt. Not a security boundary (spec/API.md, Transport; spec/RELEASES.md, Who is asking).

Ответы

  • 204 Deleted
  • 401 Error (spec/API.md). Error
  • 403 Error (spec/API.md). Error
  • 404 Error (spec/API.md). Error
  • 409 Error (spec/API.md). Error

Схемы

DashboardSummary object

id обязательный string
title обязательный LocalizedText
description LocalizedText
source обязательный DashboardSource
version обязательный integer (int64) 0 for a ready-made dashboard as shipped.

DashboardSource "ready_made" | "organization"

ready_made · organization

DashboardList object

items обязательный array of DashboardSummary

StoredDashboard object

dashboard обязательный dashboard.schema.json
source обязательный DashboardSource
version обязательный integer (int64)