API referenca

Vraća profil autentificiranog korisnika.

Ažurira polja profila poput prikaznog imena i postavki obavijesti.

Sinkronizira Supabase auth korisnika sa zapisom korisnika platforme.

Javlja je li autentificirani korisnik dovršio onboarding.

Prenosi novu sliku avatara za autentificiranog korisnika.

Navodi robote registrirane od strane autentificiranog klijenta, najnoviji prvi, do 50 unosa. Vremenske oznake su ISO 8601; last_online i last_heartbeat su null dok se robot barem jednom ne spoji.

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

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

Vraća profil klijenta autentificiranog korisnika.

Ažurira polja profila klijenta.

Navodi cloud datasetove klijenta s brojem epizoda i veličinama.

Navodi mjesečne račune klijenta.

Vraća statistiku korištenja za nadzornu ploču klijenta.

Vraća profil operatera autentificiranog korisnika.

Izrađuje ili ažurira profil operatera.

Navodi robote koji su trenutno dostupni i odgovaraju certifikacijama operatera.

Navodi zahtjeve za certifikaciju operatera i njihov status.

Zahtijeva certifikaciju za tip robota.

Vraća tjedni raspored dostupnosti operatera.

Ažurira tjedni raspored dostupnosti.

Vraća trenutnu dostupnost operatera.

Vraća statistiku zarade i sesija za nadzornu ploču operatera.

Navodi sesije autentificiranog korisnika. Operateri vide sesije kojima su upravljali; klijenti vide sesije na svojim robotima. Skup polja neznatno se 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 operatera: klijenti ne mogu pokretati sesije. Operater može istovremeno držati najviše jednu ACTIVE ili PAUSED sesiju, a robot trenutno mora imati status AVAILABLE. Pri trenutnom pokretanju robot prelazi u IN_SESSION i klijent se obavješ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 s njezinim detaljima.

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

Zahtijeva produljenje sesije. Samo klijent koji je vlasnik sesije može ovo pozvati, a sesija mora biti ACTIVE. Zahtjev se bilježi kao događaj sesije, a operater prima obavijest; samo produljenje događa se kad 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 chata unutar sesije.

Ocjenjuje dovršenu sesiju na skali od 1 do 5 zvjezdica, uz opcionalni komentar.

Izvozi podatke sesije.

Izrađuje ili vraća Stripe korisnika koji se koristi za naplatu klijenta.

Vraća status Stripe Connect računa operatera.

Pokreće onboarding za Stripe Connect radi isplata operateru.

Izrađuje Stripe SetupIntent za spremanje načina plaćanja.

Izrađuje sesiju Stripe portala za naplatu radi upravljanja načinima plaćanja i računima.

Vraća podatke o isplati za autentificiranog operatera.

Zahtijeva isplatu nakupljene zarade. Minimalna isplata iznosi 10,00 EUR.

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

Provjera zdravlja za API i njegovu vezu s bazom podataka. Vraća 200 kad su oboje u redu; ako provjera baze podataka ne uspije, vraća se isti oblik sa status i db postavljenima 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 cjenovne planove.

Šalje poruku kontakt obrasca. Poruka se prvo pohranjuje, a zatim isporučuje e-mailom, pa privremeni ispad pošte ne uzrokuje njezin gubitak: u tom slučaju odgovor prijavljuje stored true i delivered false, a isporuka se operativno ponovno 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
}

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

Vraća javnu statistiku platforme.