iRetail PRO store node 1.0.0-m1: promotions
4 операции
← Вся документация · Источник: контракты, openapi/store-v1.yaml на коммите 8000474.
Справочники на английском — на языке контрактов, из которых они созданы.
← iRetail PRO store node 1.0.0-m1
Операции
GET
/v1/promotions
The store's promotions, inactive ones included (spec/PROMOTIONS.md).
operationId
listPromotions · Право item.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). |
Ответы
POST
/v1/promotions
Create a promotion.
operationId
createPromotion · Право promotion.edit
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
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). |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonPromotionCreate
Ответы
PATCH
/v1/promotions/{id}
Change a promotion.
operationId
updatePromotion · Право promotion.edit
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
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). |
id обязательный
|
path | string (uuid) |
Id. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Тело запроса обязательный
application/jsonPromotionPatch
Ответы
DELETE
/v1/promotions/{id}
Delete a promotion.
operationId
deletePromotion · Право promotion.edit
Параметры
| Имя | Где | Тип | Описание |
|---|---|---|---|
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). |
id обязательный
|
path | string (uuid) |
Id. |
Approval-Token
|
header | string |
One-time approval from POST /v1/approvals for this operation's permission. |
Ответы
Схемы
Error object
Every error response.
error обязательный
|
string |
Stable code, see spec/API.md. |
message обязательный
|
string |
English text for logs. |
details
|
object |
LocalizedText map of string
Text by language code; the organization's default language must be present.
PromotionRule object | object
spec/PROMOTIONS.md.
Promotion object
id обязательный
|
string (uuid) |
|
name обязательный
|
LocalizedText |
|
active обязательный
|
boolean |
|
starts_at обязательный
|
string (date-time) | null |
|
ends_at обязательный
|
string (date-time) | null |
|
item_ids обязательный
|
array of string (uuid) |
|
group_ids обязательный
|
array of string (uuid) |
|
rule обязательный
|
PromotionRule |
|
version обязательный
|
integer (int64) |
PromotionCreate object
name обязательный
|
LocalizedText |
|
active
|
boolean |
|
starts_at
|
string (date-time) | null |
|
ends_at
|
string (date-time) | null |
|
item_ids
|
array of string (uuid) |
|
group_ids
|
array of string (uuid) |
|
rule обязательный
|
PromotionRule |
PromotionPatch object
name
|
LocalizedText |
|
active
|
boolean |
|
starts_at
|
string (date-time) | null |
|
ends_at
|
string (date-time) | null |
|
item_ids
|
array of string (uuid) |
|
group_ids
|
array of string (uuid) |
|
rule
|
PromotionRule |