API žinynas

Grąžina autentifikuoto naudotojo profilį.

Atnaujina profilio laukus, tokius kaip rodomas vardas ir pranešimų nuostatos.

Sinchronizuoja Supabase auth naudotoją su platformos naudotojo įrašu.

Praneša, ar autentifikuotas naudotojas baigė registraciją.

Įkelia naują avataro paveikslėlį autentifikuotam naudotojui.

Išvardija autentifikuoto kliento registruotus robotus, naujausius pirmiausia, iki 50 įrašų. Laiko žymos yra ISO 8601; last_online ir last_heartbeat yra null, kol robotas nė karto neprisijungė.

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"
  }
]

Registruoja naują robotą ir grąžina jo id. Variklio plokštės aparatinės įrangos id gali priklausyti tik vienam robotui; konfliktas atmetamas su būsena 409.

Grąžina autentifikuoto naudotojo kliento profilį.

Atnaujina kliento profilio laukus.

Išvardija kliento debesies duomenų rinkinius su epizodų skaičiais ir dydžiais.

Išvardija kliento mėnesines sąskaitas.

Grąžina naudojimo statistiką kliento valdymo skydeliui.

Grąžina autentifikuoto naudotojo operatoriaus profilį.

Sukuria arba atnaujina operatoriaus profilį.

Išvardija robotus, kurie šiuo metu laisvi ir atitinka operatoriaus sertifikatus.

Išvardija operatoriaus sertifikatų užklausas ir jų būseną.

Prašo roboto tipo sertifikato.

Grąžina operatoriaus savaitinį prieinamumo tvarkaraštį.

Atnaujina savaitinį prieinamumo tvarkaraštį.

Grąžina dabartinį operatoriaus prieinamumą.

Grąžina uždarbio ir sesijų statistiką operatoriaus valdymo skydeliui.

Išvardija autentifikuoto naudotojo sesijas. Operatoriai mato sesijas, kurias jie valdė; klientai mato sesijas ant savo robotų. Laukų rinkinys šiek tiek skiriasi tarp dviejų vaizdų: kliento vaizde yra episodes_collected ir data_collected_mb, operatoriaus vaizde yra 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."
    }
  ]
}

Pradeda teleoperacijos sesiją ant laisvo roboto. Reikalauja operatoriaus vaidmens: klientai sesijų pradėti negali. Operatorius vienu metu gali turėti daugiausiai vieną ACTIVE arba PAUSED sesiją, o robotas šiuo metu turi turėti būseną AVAILABLE. Nedelsiant pradedant, robotas persijungia į IN_SESSION, o klientui išsiunčiamas pranešimas.

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"
}

Grąžina vieną sesiją su jos detalėmis.

Atnaujina sesijos gyvavimo ciklą: pristabdymą, atnaujinimą, pabaigą ir susijusius veiksmus.

Prašo sesijos pratęsimo. Tai gali iškviesti tik sesijos savininkas klientas, ir sesija turi būti ACTIVE. Užklausa registruojama kaip sesijos įvykis, o operatorius gauna pranešimą; pats pratęsimas įvyksta, kai operatorius į jį reaguoja.

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"
}

Išvardija sesijos pokalbio žinutes.

Siunčia pokalbio žinutę sesijoje.

Įvertina baigtą sesiją 1 iki 5 žvaigždučių skalėje, su neprivalomu komentaru.

Eksportuoja sesijos duomenis.

Sukuria arba grąžina Stripe klientą, naudojamą kliento atsiskaitymui.

Grąžina operatoriaus Stripe Connect paskyros būseną.

Pradeda Stripe Connect registraciją operatoriaus išmokoms.

Sukuria Stripe SetupIntent mokėjimo būdo išsaugojimui.

Sukuria Stripe atsiskaitymo portalo sesiją mokėjimo būdams ir sąskaitoms valdyti.

Grąžina autentifikuoto operatoriaus išmokos informaciją.

Prašo sukaupto uždarbio išmokos. Minimali išmoka yra 10,00 EUR.

Priima Stripe webhook įvykius. Iškviečiamas Stripe, ne API klientų.

API ir jos duomenų bazės ryšio patikra. Grąžina 200, kai abu tvarkoje; jei duomenų bazės patikra nepavyksta, grąžinama ta pati struktūra su status ir db nustatytais į error ir HTTP būsena 503.

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

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

Grąžina viešą informaciją apie palaikomą roboto modelį.

Grąžina dabartinius viešus kainodaros planus.

Pateikia kontaktų formos žinutę. Žinutė pirmiausia išsaugoma, o tada pristatoma el. paštu, todėl laikina pašto prieinamumo pertrauka jos nepraranda: tokiu atveju atsakymas praneša stored true ir delivered false, o pristatymas bandomas dar kartą operaciniu būdu.

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
}

Prašo palaikymo roboto tipui, kurio dar nėra platformoje.

Grąžina viešą platformos statistiką.