API referenca

Vrne profil avtenticiranega uporabnika.

Posodobi polja profila, kot sta prikazano ime in nastavitve obvestil.

Uskladi uporabnika Supabase auth z zapisom uporabnika platforme.

Sporoči, ali je avtenticirani uporabnik zaključil onboarding.

Naloži novo sliko avatarja za avtenticiranega uporabnika.

Navede robote, ki jih je registrirala avtenticirana stranka, najnovejši najprej, do 50 vnosov. Časovni žigi so ISO 8601; last_online in last_heartbeat sta null, dokler se robot vsaj enkrat 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"
  }
]

Registrira novega robota in vrne njegov id. Strojni id plošče motorja lahko pripada le enemu robotu; konflikt je zavrnjen s statusom 409.

Vrne profil stranke avtenticiranega uporabnika.

Posodobi polja profila stranke.

Navede datasete stranke v oblaku s številom epizod in velikostmi.

Navede mesečne račune stranke.

Vrne statistiko uporabe za nadzorno ploščo stranke.

Vrne profil operaterja avtenticiranega uporabnika.

Ustvari ali posodobi profil operaterja.

Navede robote, ki so trenutno na voljo in ustrezajo certifikatom operaterja.

Navede zahteve operaterja za certifikate in njihovo stanje.

Zahteva certifikat za tip robota.

Vrne tedenski urnik razpoložljivosti operaterja.

Posodobi tedenski urnik razpoložljivosti.

Vrne trenutno razpoložljivost operaterja.

Vrne statistiko zaslužka in sej za nadzorno ploščo operaterja.

Navede seje avtenticiranega uporabnika. Operaterji vidijo seje, ki so jih upravljali; stranke vidijo seje na svojih robotih. Nabor polj se med pogledoma nekoliko razlikuje: pogled stranke vključuje episodes_collected in data_collected_mb, pogled operaterja pa 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."
    }
  ]
}

Zažene sejo teleoperacije na razpoložljivem robotu. Zahteva vlogo operaterja: stranke ne morejo zaganjati sej. Operater lahko hkrati drži največ eno sejo ACTIVE ali PAUSED, robot pa mora trenutno imeti stanje AVAILABLE. Ob takojšnjem zagonu robot preklopi na IN_SESSION in stranka je obveščena.

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

Vrne posamezno sejo z njenimi podrobnostmi.

Posodobi življenjski cikel seje: premor, nadaljevanje, konec in povezana dejanja.

Zahteva podaljšanje seje. To lahko pokliče le stranka, ki je lastnica seje, seja pa mora biti ACTIVE. Zahteva se zabeleži kot dogodek seje, operater pa prejme obvestilo; do samega podaljšanja pride, ko operater na to odgovori.

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

Navede sporočila klepeta seje.

Pošlje sporočilo klepeta znotraj seje.

Oceni zaključeno sejo na lestvici od 1 do 5 zvezdic, z neobveznim komentarjem.

Izvozi podatke seje.

Ustvari ali vrne uporabnika Stripe, ki se uporablja za obračunavanje stranke.

Vrne stanje računa Stripe Connect operaterja.

Sproži onboarding za Stripe Connect za izplačila operaterju.

Ustvari Stripe SetupIntent za shranjevanje načina plačila.

Ustvari sejo portala Stripe za obračunavanje za upravljanje načinov plačila in računov.

Vrne podatke o izplačilu za avtenticiranega operaterja.

Zahteva izplačilo nabranega zaslužka. Najnižje izplačilo znaša 10,00 EUR.

Prejme dogodke webhook Stripe. Pokliče ga Stripe, ne odjemalci API.

Preverjanje delovanja za API in njegovo povezavo z bazo podatkov. Vrne 200, ko sta oba v redu; če preverjanje baze podatkov spodleti, se vrne enaka oblika s status in db nastavljenima na error ter statusom HTTP 503.

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

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

Vrne javne podatke o podprtem modelu robota.

Vrne trenutne javne cenovne pakete.

Odda sporočilo kontaktnega obrazca. Sporočilo se najprej shrani, nato dostavi po e-pošti, zato začasen izpad pošte ne pomeni izgube: v tem primeru odgovor sporoči stored true in delivered false, dostava pa se operativno ponovi.

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 podporo za tip robota, ki ga na platformi še ni.

Vrne javno statistiko platforme.