API referenca

Vraća profil autentifikovanog korisnika.

Ažurira polja profila poput prikaznog imena i podešavanja obaveštenja.

Sinhronizuje Supabase auth korisnika sa zapisom korisnika platforme.

Javlja da li je autentifikovani korisnik završio onboarding.

Otprema novu sliku avatara za autentifikovanog korisnika.

Navodi robote registrovane od strane autentifikovanog klijenta, najnoviji prvi, do 50 unosa. Vremenske oznake su ISO 8601; last_online i last_heartbeat su null dok se robot bar jednom ne poveže.

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

Registruje novog robota i vraća njegov id. Hardverski id ploče motora može da pripada samo jednom robotu; sukob se odbija sa statusom 409.

Vraća profil klijenta autentifikovanog korisnika.

Ažurira polja profila klijenta.

Navodi cloud dataset-ove klijenta sa brojem epizoda i veličinama.

Navodi mesečne fakture klijenta.

Vraća statistiku korišćenja za kontrolnu tablu klijenta.

Vraća profil operatera autentifikovanog korisnika.

Kreira ili ažurira profil operatera.

Navodi robote koji su trenutno dostupni i odgovaraju sertifikacijama operatera.

Navodi zahteve za sertifikaciju operatera i njihov status.

Zahteva sertifikaciju za tip robota.

Vraća nedeljni raspored dostupnosti operatera.

Ažurira nedeljni raspored dostupnosti.

Vraća trenutnu dostupnost operatera.

Vraća statistiku zarade i sesija za kontrolnu tablu operatera.

Navodi sesije autentifikovanog korisnika. Operateri vide sesije kojima su upravljali; klijenti vide sesije na svojim robotima. Skup polja se neznatno razlikuje između dva prikaza: prikaz klijenta uključuje episodes_collected i data_collected_mb, prikaz operatera uključuje 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."
    }
  ]
}

Pokreće sesiju teleoperacije na dostupnom robotu. Zahteva ulogu operatera: klijenti ne mogu da pokreću sesije. Operater može istovremeno da drži najviše jednu ACTIVE ili PAUSED sesiju, a robot trenutno mora da ima status AVAILABLE. Pri trenutnom pokretanju robot prelazi u IN_SESSION i klijent se obaveštava.

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

Vraća jednu sesiju sa njenim detaljima.

Ažurira životni ciklus sesije: pauzu, nastavak, kraj i povezane radnje.

Zahteva produženje sesije. Samo klijent koji je vlasnik sesije može ovo da pozove, a sesija mora da bude ACTIVE. Zahtev se beleži kao događaj sesije, a operater dobija obaveštenje; samo produženje se dešava kada operater postupi po njemu.

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

Navodi poruke četa sesije.

Šalje poruku četa unutar sesije.

Ocenjuje završenu sesiju na skali od 1 do 5 zvezdica, uz opcioni komentar.

Izvozi podatke sesije.

Kreira ili vraća Stripe korisnika koji se koristi za naplatu klijenta.

Vraća status Stripe Connect naloga operatera.

Pokreće onboarding za Stripe Connect radi isplata operateru.

Kreira Stripe SetupIntent za čuvanje načina plaćanja.

Kreira sesiju Stripe portala za naplatu radi upravljanja načinima plaćanja i fakturama.

Vraća podatke o isplati za autentifikovanog operatera.

Zahteva isplatu nagomilane zarade. Minimalna isplata iznosi 10,00 EUR.

Prima Stripe webhook događaje. Poziva ga Stripe, a ne API klijenti.

Provera zdravlja za API i njegovu vezu sa bazom podataka. Vraća 200 kada su oboje u redu; ako provera baze podataka ne uspe, vraća se isti oblik sa status i db postavljenim na error i HTTP statusom 503.

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

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

Vraća javne podatke o podržanom modelu robota.

Vraća trenutne javne planove cena.

Šalje poruku kontakt forme. Poruka se prvo čuva, a zatim isporučuje putem i-mejla, pa privremeni ispad pošte ne dovodi do njenog gubitka: u tom slučaju odgovor prijavljuje stored true i delivered false, a isporuka se operativno ponovo pokušava.

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
}

Zahteva podršku za tip robota koji još nije na platformi.

Vraća javnu statistiku platforme.