Документация

Единый API к Mac: подключённые и облачные Mac вызываются одинаково.

Быстрый старт

import { Dyrra } from "@dyrra/sdk";
const dyrra = new Dyrra(process.env.DYRRA_API_KEY!);

// 1. Пользователь вашей платформы
const user = await dyrra.endUsers.create({ externalId: "user_123" });

// 2. Ссылка подключения — отправьте её пользователю
const link = await dyrra.linkSessions.create({
  endUserId: user.id,
  scopes: ["screen", "input"],
});

// 3. Дождитесь webhook connection.created, затем управляйте Mac
const mac = dyrra.targets(connectionId);
const tree = await mac.uiTree();          // структура экрана — дешевле скриншота
await mac.actions([{ type: "click", x: 200, y: 120 }, { type: "type", text: "Привет" }]);

Спецификация

OpenAPI: /v1/openapi.json. Подробности — docs/api.md в репозитории.

Все экранные координаты — логические точки главного дисплея, не пиксели Retina.

Облачные Mac

Сдаются только для разработки и тестирования ПО: сборка, автотесты, симуляторы. При создании требуется developerUseAcknowledged: true, минимальный срок аренды — сутки.

Это условия раздела 3 лицензии macOS, а не наше ограничение.