> ## 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. # Получение данных бизнесов > Получение информации о бизнесах на сервере. Доступные действия: - `list` - список всех бизнесов (требует page, limit). - `info` - информация о бизнесе (требует businessId или businessName). - `balance` - баланс бизнеса (требует businessId). - `employees` - сотрудники бизнеса (требует businessId, page, limit). - `store` - товары бизнеса (требует businessName). - `transfers` - переводы бизнеса (требует businessId, page, limit). - `rating` - топ бизнесов по балансу (требует limit). - `pending` - ожидающие заявки на создание бизнеса. ## OpenAPI ````yaml ru/openapi/ru-economy-v2-openapi.yaml GET /moscowroleplay/civops/businesses 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/businesses: get: tags: - Moscow RolePlay API Экономики V2 summary: Получение данных бизнесов description: | Получение информации о бизнесах на сервере. Доступные действия: - `list` - список всех бизнесов (требует page, limit). - `info` - информация о бизнесе (требует businessId или businessName). - `balance` - баланс бизнеса (требует businessId). - `employees` - сотрудники бизнеса (требует businessId, page, limit). - `store` - товары бизнеса (требует businessName). - `transfers` - переводы бизнеса (требует businessId, page, limit). - `rating` - топ бизнесов по балансу (требует limit). - `pending` - ожидающие заявки на создание бизнеса. parameters: - name: action in: query description: Тип действия для получения данных. required: true schema: type: string enum: - list - info - balance - employees - store - transfers - rating - pending - name: businessId in: query description: ID бизнеса (для info, balance, employees, transfers). required: false schema: type: string - name: businessName in: query description: Название бизнеса. required: false schema: type: string - name: limit in: query description: Лимит записей. required: false schema: type: integer default: 10 - name: page in: query description: Номер страницы. required: false schema: type: integer default: 1 responses: '200': description: Успешный ответ с данными бизнесов. content: application/json: schema: type: object examples: list: summary: Список бизнесов. value: page: 1 total: 50 businesses: - id: UCEW29 user_id: '760966468715937814' username: ttunku_pal name: Roma Aeterna form: ООО status: active created_at: 1761587615 approved_by: '1133665013794607114' owner_id: '760966468715937814' owner_name: ttunku_pal channel_id: '1432651696210841760' channel_name: 🇮🇹┃roma-aeterna role_id: '1432651691987304522' role_name: Roma Aeterna employee_role_id: '1432651694289846302' employee_role_name: Сотрудник Бизнеса Roma Aeterna description: >- В «Roma Aeterna» мы верим, что лучшие беседы рождаются за вкусной едой. Наше кафе создано для того, чтобы вы чувствовали себя как в гостях у друзей в солнечной Италии. info_msg_id: '1432651699952156712' address: 2221 Southern Avenue bank: 350 info: summary: Информация о бизнесе. value: business: id: UCEW29 user_id: '760966468715937814' username: ttunku_pal name: Roma Aeterna form: ООО status: active created_at: 1761587615 approved_by: '1133665013794607114' owner_id: '760966468715937814' owner_name: ttunku_pal channel_id: '1432651696210841760' channel_name: 🇮🇹┃roma-aeterna role_id: '1432651691987304522' role_name: Roma Aeterna employee_role_id: '1432651694289846302' employee_role_name: Сотрудник Бизнеса Roma Aeterna description: >- В «Roma Aeterna» мы верим, что лучшие беседы рождаются за вкусной едой. info_msg_id: '1432651699952156712' address: 2221 Southern Avenue bank: 350 balance: summary: Баланс бизнеса. value: businessId: UCEW29 balance: bank: 350 employees: summary: Сотрудники бизнеса. value: businessId: UCEW29 employees: - id: 61 business_id: UCEW29 user_id: '1335499851273601029' username: ytkaytkovich_16555 position: Сотрудник joined_at: 1761661225 - id: 65 business_id: UCEW29 user_id: '813472799280726017' username: ._ethea1th position: Менеджер joined_at: 1763834359 - id: 66 business_id: UCEW29 user_id: '1195675629010558986' username: m1xsimus_ position: Менеджер joined_at: 1763834389 totalCount: 3 store: summary: Товары бизнеса. value: businessName: Roma Aeterna items: - business_name: Roma Aeterna name: ☕ 1. Noctis Amor description: >- («Любовь ночи») Густой эспрессо с ванильной пенкой и каплей карамели. price_buy: 250 quantity: 1000 createdAt: 1761779241065 - business_name: Roma Aeterna name: '🌟 Pièce de Résistance: Aurum Caeli et Roma Aeterna' description: >- Филе осетра, обжаренное на сливочном масле с трюфельной ноткой... price_buy: 5500 quantity: 98 createdAt: 1761783355402 transfers: summary: Переводы бизнеса. value: businessId: UCEW29 rows: - id: V0CWNF2J from_business_id: UCEW29 to_business_id: RAWDB4 amount: 10000 reason: '' created_at: 1776628017744 author_id: '760966468715937814' total: 1 rating: summary: Топ бизнесов по балансу. value: count: 0 businesses: [] pending: summary: Ожидающие заявки на создание бизнеса. value: total: 2 requests: - requestId: req_abc123 userId: '1133665013794607114' username: IvanPetrov name: Tech Solutions form: ООО channelId: '1417184142227144877' status: pending created_at: 1776628017744 '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). ````