# MassFarmer GraphQL API

> Программный доступ к рабочему пространству MassFarmer. Аутентификация только через API-ключ (`X-API-KEY` + `X-TEAM-ID`).

Полная машиночитаемая справка: [llms-full.txt](https://massfarmer.com/api/llms-full.txt)
Человекочитаемая HTML-справка: [справка API](https://massfarmer.com/api/docs)
Создать API-ключ: [личный кабинет](https://massfarmer.com/dashboard/account/api)

- **Адрес:** `POST https://massfarmer.com/api/graphql`
- **Заголовок `Content-Type`:** `application/json`
- **Тело:** `{ "query": "...", "variables": { ... } }`

## Запросы

- `allAccounts`: Список аккаунтов команды. Аргументы: `first`/`after`, `filter`, `orderBy`.
- `allProfiles`: Список облачных профилей команды. Типичная первая операция — см. «Быстрый старт» в документации.
- `allTasks`: Задачи автоматизации команды с фильтрацией и сортировкой.
- `allAutoTasks`: Расписания автоматизаций команды.
- `allAutomations`: Каталог автоматизаций (глобальный справочник, только чтение).
- `allFiles`: Медиафайлы команды.
- `allProxies`: Прокси команды.
- `allServices`: Каталог платформ.
- `allPlans`: Справочник планов.
- `allLocations`: Справочник локаций.
- `accountByRowId`: Один аккаунт по UUID `rowId`.
- `profileByRowId`: Один профиль по UUID `rowId`.
- `taskByRowId`: Одна задача по UUID `rowId`.
- `autoTaskByRowId`: Одно расписание по UUID `rowId`.
- `automationByRowId`: Одна запись каталога автоматизаций по `rowId`.
- `fileByRowId`: Один файл по UUID `rowId`.
- `proxyByRowId`: Один прокси по UUID `rowId`.
- `serviceByRowId`: Одна платформа каталога по `rowId`.
- `planByRowId`: Один план по `rowId`.
- `locationByRowId`: Одна локация по `rowId`.
- `node`: Загрузка объекта по непрозрачному GraphQL Global ID (`id`). Для прикладной логики предпочитайте `*ByRowId`.
- `cloudOperationBatch`: Состояние массовой операции по UUID MassFarmer без идентификаторов облачной инфраструктуры.

## Мутации

- `createProfiles`: Создать от 1 до 1000 облачных профилей одной идемпотентной операцией.
- `createProxies`: Создать от 1 до 1000 прокси одной идемпотентной операцией.
- `createAnalyticsAccounts`: Добавить аналитические аккаунты на платформах одной массовой операцией.
- `createAutomationTasks`: Создать задачи одного сценария сразу для массива UUID профилей.
- `createAutoTask`: Создать расписание автоматизации.
- `createFile`: Загрузить видео в формате `base64` и создать запись файла.
- `updateAutoTaskByRowId`: Обновить расписание по `rowId`.
- `deleteAutoTaskByRowId`: Удалить расписание по `rowId`.
- `deleteFileByRowId`: Удалить файл по `rowId`.
- `startProfiles`: Запустить массив облачных профилей команды.
- `stopProfiles`: Остановить массив облачных профилей команды.
- `deleteProfiles`: Удалить массив облачных профилей команды.
- `reinstallProfiles`: Переустановить массив облачных профилей с параметрами по UUID.
- `refreshProfiles`: Обновить состояния массива профилей.
- `refreshProfileLocations`: Обновить геопозиции массива профилей.
- `setProfileLocations`: Изменить геопозиции массива профилей.
- `cancelProfileReinstalls`: Отменить ещё не начавшиеся переустановки массива профилей.
- `checkProxies`: Проверить массив прокси.
- `updateProxiesBulk`: Обновить массив прокси с `patch`-объектами по UUID.
- `deleteProxies`: Удалить массив прокси через массовую операцию.
- `syncAnalyticsAccounts`: Синхронизировать аналитику массива аккаунтов.
- `deleteAnalyticsAccounts`: Удалить массив аналитических аккаунтов.
- `cancelAutomationTasks`: Отменить массив ожидающих или выполняющихся задач автоматизации по UUID MassFarmer.
- `retryAutomationTasks`: Повторить массив завершившихся с ошибкой или отменённых задач по UUID MassFarmer.
- `openProfileSessions`: Подготовить защищённые сессии для массива профилей.
- `uniquizeFile`: Создать уникализированную копию видеофайла.

## Сущности (кратко)

- **Account**: Социальный аккаунт, привязанный к облачному профилю в рамках команды.
- **AutoTask**: Расписание повторяющихся автоматизаций: интервал, лимит итераций, привязка к типу сценария.
- **Automation**: Каталог доступных сценариев автоматизации (только чтение).
- **File**: Медиафайл команды. Загрузка через `createFile`: видео в формате `base64`, лимит около 100 МБ.
- **Location**: Справочник геолокаций для профилей.
- **Plan**: Справочник тарифных планов. Только чтение.
- **Profile**: Облачный телефон: единица автоматизации команды. Центральный объект для задач, прокси и аккаунтов.
- **Proxy**: Прокси для облачных профилей: поля `host`, `port` и `credentials`, статус и замена через `replaceProxy`.
- **Service**: Справочник целевых платформ (логотип, ключ). Только чтение.
- **Task**: Разовый запуск автоматизации на профиле: публикация, прогрев, вход и т.д. Создаётся вручную или из расписания.

## Для AI-ассистентов

При интеграции с Cursor, Claude, ChatGPT, Copilot загрузите `https://massfarmer.com/api/llms-full.txt` как контекст API.
Используйте `rowId` (UUID) в мутациях; `id` — непрозрачный GraphQL Global ID из ответов GraphQL.