> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.erlcrussia.com/llms.txt > Use this file to discover all available pages before exploring further. # Операции с магазином > Управление товарами магазина и покупка/продажа. Доступные действия: - `addItem` - добавить товар в магазин (требует item с name, price_buy, ...). - `removeItem` - удалить товар из магазина (требует itemName). - `buy` - купить товар у магазина (требует userId, itemName, quantity). - `sellToStore` - продать товар магазину (требует userId, itemName, quantity). ## OpenAPI ````yaml ru/openapi/ru-economy-v2-openapi.yaml POST /moscowroleplay/civops/store openapi: 3.1.0 info: title: ER:LC Россия API V2 - Moscow RolePlay API Экономики V2 version: 2.0.0 servers: - url: https://api.erlcrussia.xyz/v2 description: ER:LC Россия API V2 security: [] tags: - name: Moscow RolePlay API Экономики V2 description: Эндпоинты для управления экономикой и CivOps системой. paths: /moscowroleplay/civops/store: post: tags: - Moscow RolePlay API Экономики V2 summary: Операции с магазином description: > Управление товарами магазина и покупка/продажа. Доступные действия: - `addItem` - добавить товар в магазин (требует item с name, price_buy, ...). - `removeItem` - удалить товар из магазина (требует itemName). - `buy` - купить товар у магазина (требует userId, itemName, quantity). - `sellToStore` - продать товар магазину (требует userId, itemName, quantity). parameters: - name: action in: query description: Тип операции. required: true schema: type: string enum: - addItem - removeItem - buy - sellToStore requestBody: required: true content: application/json: schema: type: object examples: addItem: summary: Добавить товар в общий магазин value: item: name: Вино "🍷The Box" price_buy: 50000 price_sell: 0 description: >- В нём живёт свет первых встреч. Тёплый, как смех, что согревал пустые комнаты. quantity: 1000 can_use: false can_sell: false removeItem: summary: Удалить товар из общего магазина value: itemName: Вино "🍷The Box" buy: summary: Купить товар из общего магазина value: userId: '1133665013794607114' itemName: Петух quantity: 1 sellToStore: summary: Продать товар в магазин value: userId: '1133665013794607114' itemName: Вино "🍷The Box" quantity: 5 responses: '200': description: Операция успешно выполнена. content: application/json: schema: type: object examples: addItem: summary: Товар добавлен. value: success: true item: Вино "🍷The Box" price_buy: 50000 price_sell: 0 quantity: 1000 can_use: false can_sell: false buy: summary: Успешная покупка. value: success: true userId: '1133665013794607114' item: Петух quantity: 1 totalPrice: 2000 sellToStore: summary: Успешная продажа. value: success: true userId: '1133665013794607114' item: Вино "🍷The Box" quantity: 5 totalPrice: 0 '400': description: >- Ошибка запроса (отсутствуют обязательные поля, товар не найден или неизвестный action). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/UnauthorizedMissingOrInvalidToken' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' security: - MRPAPIKey: [] components: schemas: ErrorResponse: type: object description: Стандартный формат ошибки. required: - code - message properties: code: type: integer description: Код ошибки API. example: 5007 message: type: string description: Сообщение/идентификатор ошибки. example: Missing Token UnauthorizedError: type: object description: Ошибка аутентификации (отсутствует или неверный токен). required: - code - message properties: code: type: integer example: 5007 message: type: string example: Missing Token ForbiddenError: type: object description: Ошибка доступа (запрещено). required: - code - message properties: code: type: integer example: 5009 message: type: string example: Forbidden RateLimitError: type: object description: Ошибка превышения лимита запросов. required: - code - message properties: code: type: integer example: 6021 message: type: string example: Rate Limit Exceeded retry_after: type: integer description: Время до сброса лимита в секундах. example: 30 EconomyApiError: type: object description: Ошибка API Экономики. required: - code - message properties: code: type: integer example: 6010 message: type: string example: Business not found responses: UnauthorizedMissingOrInvalidToken: description: Ошибка аутентификации. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' examples: Missing Token: summary: Нет токена. value: code: 5007 message: Missing Token Invalid Token: summary: Неверный или деактивированный токен. value: code: 5008 message: Invalid Token Invalid Master Key: summary: Неверный мастер-ключ. value: code: 5006 message: Invalid Master Key Forbidden: description: Доступ запрещён. content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' examples: Forbidden: summary: Нет прав доступа к эндпоинту. value: code: 5009 message: Forbidden Api Version Forbidden: summary: Доступ к этой версии API запрещён. value: code: 5010 message: Api Version Forbidden Query Param Forbidden: summary: Query-параметр запрещён. value: code: 5011 message: Query Param Forbidden TooManyRequests: description: Превышено количество запросов. headers: X-RateLimit-Limit: description: Максимум запросов в минуту. schema: type: integer example: 60 X-RateLimit-Remaining: description: Оставшееся количество запросов. schema: type: integer example: 0 Retry-After: description: Секунд до сброса лимита. schema: type: integer example: 30 content: application/json: schema: $ref: '#/components/schemas/RateLimitError' examples: Rate Limit Exceeded: summary: Превышение лимита запросов. value: code: 6021 message: Rate Limit Exceeded retry_after: 30 InternalServerError: description: Внутренняя ошибка сервера. content: application/json: schema: $ref: '#/components/schemas/EconomyApiError' examples: Internal Server Error Occurred: summary: Ошибка API экономики. value: code: 6005 message: Internal Server Error Occurred. securitySchemes: MRPAPIKey: type: http scheme: bearer bearerFormat: API Key description: | API ключ для доступа к эндпоинтам Гражданских Операций. Передается в заголовке `Authorization: Bearer <ключ>`. ОБЯЗАТЕЛЕН ДЛЯ ВСЕХ ЭНДПОИНТОВ ГРАЖДАНСКИХ ОПЕРАЦИЙ (кроме /health). ````