API-справочник

Возвращает профиль аутентифицированного пользователя.

Обновляет поля профиля, такие как отображаемое имя и настройки уведомлений.

Синхронизирует пользователя аутентификации Supabase с записью пользователя платформы.

Сообщает, завершил ли аутентифицированный пользователь онбординг.

Загружает новое изображение аватара для аутентифицированного пользователя.

Перечисляет роботов, зарегистрированных аутентифицированным клиентом, сначала новые, до 50 записей. Временные метки в формате ISO 8601; last_online и last_heartbeat равны null, пока робот ни разу не подключился.

curl https://www.ay-robots.com/api/client/robots \
  -H 'Authorization: Bearer ayr_live_your_key_here'

[
  {
    "id": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11",
    "name": "Lab SO-100",
    "robot_type": "SO-100",
    "status": "AVAILABLE",
    "control_url": "wss://robots.example.com/so100/control",
    "stream_url": "https://robots.example.com/so100/stream",
    "hardware_id": "board:local:usb-1",
    "last_online": "2026-08-09T10:12:00.000Z",
    "last_heartbeat": "2026-08-09T10:12:00.000Z",
    "total_hours": 12.5,
    "tags": ["lab"],
    "notes": null,
    "created_at": "2026-07-01T09:00:00.000Z"
  }
]

Регистрирует нового робота и возвращает его id. Hardware id платы мотора может принадлежать только одному роботу; коллизия отклоняется со статусом 409.

Возвращает профиль клиента аутентифицированного пользователя.

Обновляет поля профиля клиента.

Перечисляет облачные датасеты клиента с количеством эпизодов и размерами.

Перечисляет месячные счета клиента.

Возвращает статистику использования для дашборда клиента.

Возвращает профиль оператора аутентифицированного пользователя.

Создаёт или обновляет профиль оператора.

Перечисляет роботов, которые сейчас доступны и соответствуют сертификациям оператора.

Перечисляет запросы на сертификацию оператора и их статус.

Запрашивает сертификацию на тип робота.

Возвращает недельное расписание доступности оператора.

Обновляет недельное расписание доступности.

Возвращает текущую доступность оператора.

Возвращает статистику заработка и сессий для дашборда оператора.

Перечисляет сессии аутентифицированного пользователя. Операторы видят сессии, которыми они управляли; клиенты видят сессии на своих роботах. Набор полей немного различается между двумя видами: клиентский вид включает episodes_collected и data_collected_mb, операторский вид включает operator_earnings_cents.

curl 'https://www.ay-robots.com/api/sessions?status=COMPLETED&limit=10' \
  -H 'Authorization: Bearer ayr_live_your_key_here'

{
  "sessions": [
    {
      "id": "6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30",
      "status": "COMPLETED",
      "started_at": "2026-08-08T14:00:12.000Z",
      "ended_at": "2026-08-08T14:47:31.000Z",
      "duration_minutes": 47,
      "client_charge_cents": 1175,
      "episodes_collected": 23,
      "data_collected_mb": 210.4,
      "rating": 5,
      "created_at": "2026-08-08T13:59:58.000Z",
      "robot_id": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11",
      "robot_name": "Lab SO-100",
      "robot_type": "SO-100",
      "operator_name": "Jane D."
    }
  ]
}

Запускает сессию телеоперации на доступном роботе. Требует роль оператора: клиенты не могут запускать сессии. Оператор может держать не более одной сессии ACTIVE или PAUSED одновременно, а робот в этот момент должен иметь статус AVAILABLE. При немедленном запуске робот переходит в IN_SESSION, и клиент получает уведомление.

curl -X POST https://www.ay-robots.com/api/sessions \
  -H 'Authorization: Bearer ayr_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"robotId": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11"}'

{
  "sessionId": "6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30",
  "status": "ACTIVE"
}

Возвращает одну сессию с её деталями.

Обновляет жизненный цикл сессии: пауза, возобновление, завершение и связанные действия.

Запрашивает продление сессии. Вызывать может только клиент, которому принадлежит сессия, и сессия должна быть ACTIVE. Запрос логируется как событие сессии, а оператор получает уведомление; само продление происходит, когда оператор реагирует на него.

curl -X POST https://www.ay-robots.com/api/sessions/6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30/extend \
  -H 'Authorization: Bearer ayr_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"additionalMinutes": 30}'

{
  "message": "Extension request sent to operator"
}

Перечисляет сообщения чата сессии.

Отправляет сообщение в чате сессии.

Оценивает завершённую сессию по шкале от 1 до 5 звёзд с опциональным комментарием.

Экспортирует данные сессии.

Создаёт или возвращает клиента Stripe, используемого для биллинга клиента.

Возвращает статус аккаунта Stripe Connect оператора.

Запускает онбординг Stripe Connect для выплат оператору.

Создаёт Stripe SetupIntent для сохранения способа оплаты.

Создаёт сессию биллингового портала Stripe для управления способами оплаты и счетами.

Возвращает информацию о выплатах для аутентифицированного оператора.

Запрашивает выплату накопленного заработка. Минимальная выплата составляет 10,00 EUR.

Принимает webhook-события Stripe. Вызывается Stripe, а не клиентами API.

Проверка здоровья API и его подключения к базе данных. Возвращает 200, когда всё в порядке; если проверка базы данных не проходит, возвращается та же форма с status и db, установленными в error, и HTTP-статусом 503.

curl https://www.ay-robots.com/api/health

{
  "status": "ok",
  "db": "ok",
  "timestamp": "2026-08-09T10:12:00.000Z"
}

Возвращает публичную информацию о поддерживаемой модели робота.

Возвращает текущие публичные тарифные планы.

Отправляет сообщение из контактной формы. Сообщение сначала сохраняется, а затем доставляется по email, поэтому временный сбой почты не приводит к его потере: в этом случае ответ сообщает stored true и delivered false, а доставка повторяется в фоновом режиме.

curl -X POST https://www.ay-robots.com/api/contact \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Jane Doe",
    "email": "jane@example.com",
    "category": "Technical Support",
    "subject": "SO-100 pairing question",
    "message": "My arm shows as offline after pairing."
  }'

{
  "success": true,
  "message": "Message sent successfully",
  "id": "b1f2c3d4-0000-0000-0000-000000000000",
  "stored": true,
  "delivered": true
}

Запрашивает поддержку типа робота, которого ещё нет на платформе.

Возвращает публичную статистику платформы.