Reference API

Vrátí profil autentizovaného uživatele.

Aktualizuje pole profilu, jako je zobrazované jméno a nastavení notifikací.

Synchronizuje uživatele Supabase Auth se záznamem uživatele na platformě.

Hlásí, zda autentizovaný uživatel dokončil onboarding.

Nahraje nový obrázek avataru pro autentizovaného uživatele.

Vypíše roboty registrované autentizovaným klientem, od nejnovějších, až do 50 záznamů. Časové značky jsou ve formátu ISO 8601; last_online a last_heartbeat jsou null, dokud se robot alespoň jednou nepřipojil.

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átí jeho id. Hardwarové id motorové desky může patřit jen jednomu robotu; kolize je odmítnuta se stavem 409.

Vrátí klientský profil autentizovaného uživatele.

Aktualizuje pole klientského profilu.

Vypíše cloudové datasety klienta s počty epizod a velikostmi.

Vypíše měsíční faktury klienta.

Vrátí statistiky využití pro dashboard klienta.

Vrátí operátorský profil autentizovaného uživatele.

Vytvoří nebo aktualizuje operátorský profil.

Vypíše roboty, kteří jsou aktuálně dostupní a odpovídají certifikacím operátora.

Vypíše žádosti o certifikaci operátora a jejich stav.

Vyžádá certifikaci pro typ robota.

Vrátí týdenní plán dostupnosti operátora.

Aktualizuje týdenní plán dostupnosti.

Vrátí aktuální dostupnost operátora.

Vrátí statistiky výdělků a session pro dashboard operátora.

Vypíše session pro autentizovaného uživatele. Operátoři vidí session, které řídili; klienti vidí session na svých robotech. Sada polí se mezi oběma pohledy mírně liší: klientský pohled obsahuje episodes_collected a data_collected_mb, pohled operátora obsahuje 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í teleoperační session na dostupném robotu. Vyžaduje roli operátora: klienti session spouštět nemohou. Operátor může naráz držet nejvýš jednu session ve stavu ACTIVE nebo PAUSED a robot musí mít v danou chvíli stav AVAILABLE. Při okamžitém spuštění se robot přepne na IN_SESSION a klient je upozorněn.

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átí jednu session s jejími detaily.

Aktualizuje životní cyklus session: pozastavení, obnovení, ukončení a související akce.

Vyžádá prodloužení session. Volat to může jen klient, kterému session patří, a session musí být ACTIVE. Žádost se zaznamená jako událost session a operátor dostane notifikaci; samotné prodloužení proběhne, až na ni 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"
}

Vypíše chatové zprávy session.

Pošle chatovou zprávu v session.

Ohodnotí dokončenou session na škále 1 až 5 hvězdiček, s volitelným komentářem.

Exportuje data session.

Vytvoří nebo vrátí Stripe zákazníka použitého pro fakturaci klienta.

Vrátí stav Stripe Connect účtu operátora.

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

Vytvoří Stripe SetupIntent pro uložení platební metody.

Vytvoří session Stripe billing portálu pro správu platebních metod a faktur.

Vrátí informace o výplatě pro autentizovaného operátora.

Vyžádá výplatu nashromážděných výdělků. Minimální výplata je 10,00 EUR.

Přijímá webhook události Stripe. Volá ho Stripe, ne klienti API.

Kontrola stavu API a jeho připojení k databázi. Vrací 200, když je vše v pořádku; pokud kontrola databáze selže, vrátí se stejný tvar se status a db nastavenými na error a HTTP stavem 503.

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

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

Vrátí veřejné informace o podporovaném modelu robota.

Vrátí aktuální veřejné cenové plány.

Odešle zprávu z kontaktního formuláře. Zpráva se nejdřív uloží a poté doručí e-mailem, takže dočasný výpadek pošty ji neztratí: v takovém případě odpověď hlásí stored true a delivered false a doručení se provozně opakuje.

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žádá podporu pro typ robota, který zatím na platformě není.

Vrátí veřejné statistiky platformy.