API referenca

Vraća profil autentikovanog korisnika.

Ažurira polja profila poput prikazanog imena i preferenci obavještenja.

Sinhronizuje Supabase auth korisnika sa zapisom korisnika platforme.

Izvještava da li je autentikovani korisnik završio onboarding.

Otprema novu sliku avatara za autentikovanog korisnika.

Navodi robote registrovane od strane autentikovanog klijenta, najnovije prvo, do 50 unosa. Vremenske oznake su ISO 8601; last_online i last_heartbeat su null dok se robot barem 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. Hardware id ploče motora može pripadati samo jednom robotu; sukob se odbija sa statusom 409.

Vraća profil klijenta autentikovanog korisnika.

Ažurira polja profila klijenta.

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

Navodi mjesečne fakture klijenta.

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

Vraća profil operatera autentikovanog korisnika.

Kreira ili ažurira profil operatera.

Navodi robote koji su trenutno dostupni i odgovaraju certifikacijama operatera.

Navodi zahtjeve za certifikaciju operatera i njihov status.

Traži certifikaciju za tip robota.

Vraća sedmični raspored dostupnosti operatera.

Ažurira sedmični raspored dostupnosti.

Vraća trenutnu dostupnost operatera.

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

Navodi sesije za autentikovanog korisnika. Operateri vide sesije kojima su upravljali; klijenti vide sesije na svojim robotima. Skup polja se malo 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. Zahtijeva ulogu operater: klijenti ne mogu pokretati sesije. Operater može držati najviše jednu ACTIVE ili PAUSED sesiju u isto vrijeme, a robot mora trenutno imati status AVAILABLE. Pri trenutnom pokretanju robot prelazi u IN_SESSION i klijent biva obaviješten.

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 pojedinačnu sesiju sa njenim detaljima.

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

Traži produženje sesije. Samo klijent koji je vlasnik sesije može ovo pozvati, a sesija mora biti ACTIVE. Zahtjev se bilježi kao aktivnost sesije i operater dobija obavješ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 chata sesije.

Šalje poruku u chatu sesije.

Ocjenjuje završenu sesiju na skali od 1 do 5 zvjezdica, sa opcionim komentarom.

Izvozi podatke sesije.

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

Vraća status Stripe Connect računa operatera.

Pokreće Stripe Connect onboarding za isplate operatera.

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

Kreira Stripe billing portal sesiju za upravljanje načinima plaćanja i fakturama.

Vraća informacije o isplati za autentikovanog operatera.

Traži isplatu akumulirane zarade. Minimalna isplata je 10,00 EUR.

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

Provjera zdravlja za API i njegovu vezu sa bazom podataka. Vraća 200 kada je oboje u redu; ako provjera baze podataka ne uspije, 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 informacije o podržanom modelu robota.

Vraća trenutne javne planove cijena.

Šalje poruku putem kontakt obrasca. Poruka se prvo čuva, a zatim isporučuje putem emaila, tako da privremeni prekid pošte ne izgubi poruku: u tom slučaju odgovor prijavljuje stored true i delivered false, a isporuka se operativno ponavlja.

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
}

Traži podršku za tip robota koji još nije na platformi.

Vraća javnu statistiku platforme.