Referencia API

Vráti profil autentifikovaného používateľa.

Aktualizuje polia profilu, ako je zobrazované meno a preferencie oznámení.

Synchronizuje používateľa Supabase auth so záznamom používateľa platformy.

Nahlási, či autentifikovaný používateľ dokončil onboarding.

Nahrá nový obrázok avatara pre autentifikovaného používateľa.

Zobrazí zoznam robotov registrovaných autentifikovaným klientom, najnovšie prvé, až 50 záznamov. Časové značky sú vo formáte ISO 8601; last_online a last_heartbeat sú null, kým sa robot raz nepripojí.

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

Zaregistruje nového robota a vráti jeho id. Hardvérové id dosky motora môže patriť len jednému robotovi; kolízia sa odmietne so stavom 409.

Vráti klientsky profil autentifikovaného používateľa.

Aktualizuje polia klientskeho profilu.

Zobrazí zoznam cloudových datasetov klienta s počtami epizód a veľkosťami.

Zobrazí zoznam mesačných faktúr klienta.

Vráti štatistiky používania pre klientsky dashboard.

Vráti profil operátora autentifikovaného používateľa.

Vytvorí alebo aktualizuje profil operátora.

Zobrazí zoznam robotov, ktoré sú aktuálne dostupné a zodpovedajú certifikáciám operátora.

Zobrazí zoznam žiadostí operátora o certifikáciu a ich stav.

Vyžiada certifikáciu pre daný typ robota.

Vráti týždenný plán dostupnosti operátora.

Aktualizuje týždenný plán dostupnosti.

Vráti aktuálnu dostupnosť operátora.

Vráti štatistiky zárobkov a relácií pre dashboard operátora.

Zobrazí zoznam relácií pre autentifikovaného používateľa. Operátori vidia relácie, ktoré viedli; klienti vidia relácie na svojich robotoch. Súbor polí sa medzi oboma pohľadmi mierne líši: klientský pohľad zahŕňa episodes_collected a data_collected_mb, pohľad operátora zahŕňa 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."
    }
  ]
}

Spustí reláciu teleoperácie na dostupnom robotovi. Vyžaduje rolu operátor: klienti nemôžu relácie spúšťať. Operátor môže mať naraz najviac jednu reláciu ACTIVE alebo PAUSED a robot musí mať aktuálne stav AVAILABLE. Pri okamžitom spustení sa robot prepne na IN_SESSION a klient dostane upozornenie.

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

Vráti jednu reláciu s jej detailmi.

Aktualizuje životný cyklus relácie: pozastavenie, obnovenie, ukončenie a súvisiace akcie.

Vyžiada predĺženie relácie. Volať to môže len klient, ktorý reláciu vlastní, a relácia musí byť ACTIVE. Žiadosť sa zaznamená ako udalosť relácie a operátor dostane oznámenie; samotné predĺženie nastane, keď na to operátor zareaguje.

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

Zobrazí zoznam chatových správ relácie.

Odošle chatovú správu v relácii.

Ohodnotí dokončenú reláciu na škále od 1 do 5 hviezdičiek, s voliteľným komentárom.

Exportuje dáta relácie.

Vytvorí alebo vráti zákazníka Stripe používaného na fakturáciu klienta.

Vráti stav účtu Stripe Connect operátora.

Spustí onboarding Stripe Connect pre výplaty operátorovi.

Vytvorí Stripe SetupIntent na uloženie spôsobu platby.

Vytvorí reláciu fakturačného portálu Stripe na správu spôsobov platby a faktúr.

Vráti informácie o výplate pre autentifikovaného operátora.

Vyžiada výplatu nazbieraných zárobkov. Minimálna výplata je 10,00 EUR.

Prijíma udalosti webhooku Stripe. Volá ho Stripe, nie klienti API.

Kontrola zdravia pre API a jeho pripojenie k databáze. Vráti 200, keď je oboje v poriadku; ak kontrola databázy zlyhá, vráti sa rovnaká štruktúra so status a db nastavenými na error a stavom HTTP 503.

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

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

Vráti verejné informácie o podporovanom modeli robota.

Vráti aktuálne verejné cenové plány.

Odošle správu z kontaktného formulára. Správa sa najprv uloží a potom doručí e-mailom, takže dočasný výpadok pošty ju nestratí: v takom prípade odpoveď hlási stored true a delivered false a doručenie sa prevádzkovo znovu skúša.

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
}

Vyžiada podporu pre typ robota, ktorý ešte nie je na platforme.

Vráti verejné štatistiky platformy.