> ## 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` - информация о мафии (mafiaId или mafiaName) - `balance` - баланс мафии (mafiaId) - `members` - члены мафии (mafiaId, page, limit) - `transfers` - переводы мафии (mafiaId, page, limit) - `logs` - логи мафии (mafiaId, limit) ## OpenAPI ````yaml ru/openapi/ru-economy-v2-openapi.yaml GET /moscowroleplay/civops/mafias 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/mafias: get: tags: - Moscow RolePlay API Экономики V2 summary: Получение данных мафий description: | Получение информации о мафиозных группировках на сервере. Доступные действия: - `list` - список всех мафий (page, limit) - `info` - информация о мафии (mafiaId или mafiaName) - `balance` - баланс мафии (mafiaId) - `members` - члены мафии (mafiaId, page, limit) - `transfers` - переводы мафии (mafiaId, page, limit) - `logs` - логи мафии (mafiaId, limit) parameters: - name: action in: query description: Тип действия для получения данных. required: true schema: type: string enum: - list - info - balance - members - transfers - logs - name: mafiaId in: query description: ID мафии (для info, balance, members, transfers, logs). required: false schema: type: string - name: mafiaName in: query description: Название мафии (для info). required: false schema: type: string - name: limit in: query description: Лимит записей (по умолчанию 10). required: false schema: type: integer default: 10 - name: page in: query description: Номер страницы (по умолчанию 1). required: false schema: type: integer default: 1 responses: '200': description: Успешный ответ с данными мафий. content: application/json: schema: type: object examples: list: summary: Список мафий. value: page: 1 total: 1 mafias: - id: 2KH2WQEO name: UKpanik leader_id: '1104388035199639585' leader_name: forziknerves role_id: '1473315569175625811' role_name: Состоит в ОПГ "UKpanik" leader_role_id: '1473315758783201354' leader_role_name: Лидер ОПГ "UKpanik" channel_id: '1473316097032716381' channel_name: 💬┃ukpanik color: '#060568' created_at: 1776881763 bank: 0 info: summary: Информация о мафии. value: mafia: id: 2KH2WQEO name: UKpanik leader_id: '1104388035199639585' leader_name: forziknerves role_id: '1473315569175625811' role_name: Состоит в ОПГ "UKpanik" leader_role_id: '1473315758783201354' leader_role_name: Лидер ОПГ "UKpanik" channel_id: '1473316097032716381' channel_name: 💬┃ukpanik color: '#060568' created_at: 1776881763 bank: 0 members: - user_id: '1104388035199639585' username: forziknerves position: Лидер joined_at: 1776881763 memberCount: 1 balance: summary: Баланс мафии. value: mafiaId: 2KH2WQEO balance: bank: 0 members: summary: Члены мафии. value: mafiaId: 2KH2WQEO members: - user_id: '1104388035199639585' username: forziknerves position: Лидер joined_at: 1776881763 totalCount: 1 transfers: summary: Переводы мафии. value: mafiaId: 2KH2WQEO rows: [] total: 0 logs: summary: Логи мафии. value: mafiaId: 2KH2WQEO logs: - id: 5 mafia_id: 2KH2WQEO action: create value: Создана ОПГ UKpanik лидером 1170030084300742680 created_at: 1776881763 '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). ````