Справочник на API

Връща профила на автентикирания потребител.

Актуализира полета на профила, като показваното име и предпочитанията за известия.

Синхронизира потребителя от Supabase auth с потребителския запис на платформата.

Съобщава дали автентикираният потребител е завършил onboarding.

Качва ново изображение за аватар на автентикирания потребител.

Показва списък с роботите, регистрирани от автентикирания клиент, най-новите първи, до 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. Хардуерен идентификатор на двигателна платка може да принадлежи само на един робот; сблъсък се отхвърля със статус 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.

Стартира onboarding в 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"
}

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

Връща текущите публични ценови планове.

Изпраща съобщение от контактната форма. Съобщението първо се съхранява, а след това се доставя по имейл, така че временен срив на пощата не го губи: в такъв случай отговорът съобщава 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
}

Заявява поддръжка за тип робот, който все още не е в платформата.

Връща публични статистики на платформата.