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. Hardware id на плоча со мотор може да припаѓа само на еден робот; судир се одбива со статус 409.

Го враќа профилот на клиентот на автентицираниот корисник.

Ги ажурира полињата на профилот на клиентот.

Ги наведува dataset-ите во облак на клиентот со број на епизоди и големини.

Ги наведува месечните фактури на клиентот.

Враќа статистики за користење за контролната табла на клиентот.

Го враќа профилот на операторот на автентицираниот корисник.

Создава или ажурира профил на оператор.

Ги наведува роботите кои се тековно достапни и се совпаѓаат со сертификациите на операторот.

Ги наведува барањата за сертификација на операторот и нивниот статус.

Бара сертификација за тип робот.

Го враќа неделниот распоред на достапност на операторот.

Го ажурира неделниот распоред на достапност.

Ја враќа тековната достапност на операторот.

Враќа статистики за заработка и сесии за контролната табла на операторот.

Ги наведува сесиите за автентицираниот корисник. Операторите гледаат сесии со кои управувале; клиентите гледаат сесии на нивните роботи. Множеството полиња малку се разликува меѓу двата приказа: приказот за клиент вклучува 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 onboarding за исплати на операторот.

Создава Stripe SetupIntent за зачувување начин на плаќање.

Создава Stripe billing portal сесија за управување со начини на плаќање и фактури.

Враќа информации за исплата на автентицираниот оператор.

Бара исплата на акумулираната заработка. Минималната исплата е 10,00 EUR.

Прима настани од Stripe webhook. Ги повикува 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
}

Бара поддршка за тип робот кој сѐ уште не е на платформата.

Враќа јавни статистики на платформата.