API atsauce

Atgriež autentificētā lietotāja profilu.

Atjaunina profila laukus, piemēram, redzamo vārdu un paziņojumu preferences.

Sinhronizē Supabase auth lietotāju ar platformas lietotāja ierakstu.

Ziņo, vai autentificētais lietotājs ir pabeidzis reģistrāciju.

Augšupielādē jaunu avatara attēlu autentificētajam lietotājam.

Uzskaita autentificētā klienta reģistrētos robotus, jaunākos vispirms, līdz 50 ierakstiem. Laika zīmogi ir ISO 8601; last_online un last_heartbeat ir null, kamēr robots vēl nav pieslēdzies nevienu reizi.

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

Reģistrē jaunu robotu un atgriež tā id. Motora plates aparatūras id var piederēt tikai vienam robotam; konflikts tiek noraidīts ar statusu 409.

Atgriež autentificētā lietotāja klienta profilu.

Atjaunina klienta profila laukus.

Uzskaita klienta mākoņa datu kopas ar epizožu skaitiem un izmēriem.

Uzskaita klienta ikmēneša rēķinus.

Atgriež lietojuma statistiku klienta vadības panelim.

Atgriež autentificētā lietotāja operatora profilu.

Izveido vai atjaunina operatora profilu.

Uzskaita robotus, kas šobrīd ir pieejami un atbilst operatora sertifikātiem.

Uzskaita operatora sertifikātu pieprasījumus un to statusu.

Pieprasa sertifikātu robota tipam.

Atgriež operatora iknedēļas pieejamības grafiku.

Atjaunina iknedēļas pieejamības grafiku.

Atgriež operatora pašreizējo pieejamību.

Atgriež ienākumu un sesiju statistiku operatora vadības panelim.

Uzskaita autentificētā lietotāja sesijas. Operatori redz sesijas, kuras viņi vadīja; klienti redz sesijas uz saviem robotiem. Lauku kopa nedaudz atšķiras starp abiem skatiem: klienta skatā ir episodes_collected un data_collected_mb, operatora skatā ir 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."
    }
  ]
}

Sāk teleoperācijas sesiju uz pieejama robota. Nepieciešama operatora loma: klienti nevar sākt sesijas. Operators vienlaikus var uzturēt ne vairāk kā vienu ACTIVE vai PAUSED sesiju, un robotam pašlaik jābūt statusā AVAILABLE. Tūlītējas sākšanas gadījumā robots pāriet uz IN_SESSION, un klients saņem paziņojumu.

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

Atgriež vienu sesiju ar tās detaļām.

Atjaunina sesijas dzīves ciklu: apturēšanu, atsākšanu, beigšanu un saistītas darbības.

Pieprasa sesijas pagarinājumu. To var izsaukt tikai klients, kuram pieder sesija, un sesijai jābūt ACTIVE. Pieprasījums tiek reģistrēts kā sesijas notikums, un operators saņem paziņojumu; pats pagarinājums notiek, kad operators uz to reaģē.

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

Uzskaita sesijas tērzēšanas ziņojumus.

Nosūta tērzēšanas ziņojumu sesijā.

Novērtē pabeigtu sesiju 1 līdz 5 zvaigžņu skalā, ar neobligātu komentāru.

Eksportē sesijas datus.

Izveido vai atgriež Stripe klientu, ko izmanto klienta norēķiniem.

Atgriež operatora Stripe Connect konta statusu.

Sāk Stripe Connect reģistrāciju operatoru izmaksām.

Izveido Stripe SetupIntent maksājumu metodes saglabāšanai.

Izveido Stripe norēķinu portāla sesiju maksājumu metožu un rēķinu pārvaldīšanai.

Atgriež izmaksas informāciju autentificētajam operatoram.

Pieprasa uzkrāto ienākumu izmaksu. Minimālā izmaksa ir 10,00 EUR.

Saņem Stripe webhook notikumus. Izsauc Stripe, nevis API klienti.

API un tās datubāzes savienojuma pārbaude. Atgriež 200, kad abi ir kārtībā; ja datubāzes pārbaude neizdodas, tiek atgriezta tā pati struktūra ar status un db iestatītiem uz error un HTTP statusu 503.

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

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

Atgriež publisku informāciju par atbalstītu robota modeli.

Atgriež pašreizējos publiskos cenu plānus.

Iesniedz kontaktu formas ziņojumu. Ziņojums vispirms tiek saglabāts un pēc tam piegādāts pa e-pastu, tāpēc īslaicīgs pasta pārtraukums to nepazaudē: šādā gadījumā atbilde ziņo stored true un delivered false, un piegāde tiek atkārtota operacionāli.

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
}

Pieprasa atbalstu robota tipam, kas platformā vēl nav pieejams.

Atgriež publisku platformas statistiku.