API viitematerjal

Tagastab autenditud kasutaja profiili.

Uuendab profiiliväljasid, näiteks kuvatavat nime ja teavituseelistusi.

Sünkroniseerib Supabase auth kasutaja platvormi kasutajakirjega.

Teatab, kas autenditud kasutaja on registreerumise lõpetanud.

Laadib üles uue avatari pildi autenditud kasutajale.

Loetleb autenditud kliendi registreeritud robotid, uuemad esimesena, kuni 50 kirjet. Ajatemplid on ISO 8601 kujul; last_online ja last_heartbeat on null, kuni robot pole kordagi ühendunud.

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

Registreerib uue roboti ja tagastab selle id. Mootoriplaadi riistvara id saab kuuluda ainult ühele robotile; konflikt lükatakse tagasi olekuga 409.

Tagastab autenditud kasutaja kliendiprofiili.

Uuendab kliendiprofiili väljasid.

Loetleb kliendi pilveandmestikud koos episoodide arvu ja suurustega.

Loetleb kliendi igakuised arved.

Tagastab kasutusstatistika kliendi töölaua jaoks.

Tagastab autenditud kasutaja operaatoriprofiili.

Loob või uuendab operaatoriprofiili.

Loetleb robotid, mis on hetkel saadaval ja vastavad operaatori sertifikaatidele.

Loetleb operaatori sertifikaaditaotlused ja nende oleku.

Taotleb sertifikaati robotitüübi jaoks.

Tagastab operaatori iganädalase saadavuse graafiku.

Uuendab iganädalast saadavuse graafikut.

Tagastab operaatori praeguse saadavuse.

Tagastab teenistuse ja seansside statistika operaatori töölaua jaoks.

Loetleb autenditud kasutaja seansid. Operaatorid näevad seansse, mida nad juhtisid; kliendid näevad seansse oma robotitel. Väljade komplekt erineb kahe vaate vahel veidi: kliendi vaates on episodes_collected ja data_collected_mb, operaatori vaates on 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."
    }
  ]
}

Alustab teleoperatsiooni seanssi saadaoleval robotil. Nõuab operaatori rolli: kliendid ei saa seansse alustada. Operaator saab korraga hoida kõige rohkem ühte ACTIVE või PAUSED seanssi ja robot peab hetkel olema olekus AVAILABLE. Kohese alustamise korral lülitub robot olekusse IN_SESSION ja klient saab teavituse.

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

Tagastab ühe seansi koos üksikasjadega.

Uuendab seansi elutsüklit: pausile panek, jätkamine, lõpetamine ja seotud toimingud.

Taotleb seansi pikendamist. Seda saab kutsuda ainult klient, kellele seanss kuulub, ja seanss peab olema ACTIVE. Taotlus registreeritakse seansisündmusena ja operaator saab teavituse; pikendus ise toimub siis, kui operaator sellele reageerib.

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

Loetleb seansi vestlussõnumid.

Saadab vestlussõnumi seansis.

Hindab lõpetatud seanssi 1 kuni 5 tärniga skaalal, koos valikulise kommentaariga.

Ekspordib seansi andmed.

Loob või tagastab Stripe kliendi, mida kasutatakse kliendi arvelduseks.

Tagastab operaatori Stripe Connecti konto oleku.

Alustab Stripe Connecti registreerumist operaatori väljamaksete jaoks.

Loob Stripe SetupIntenti maksemeetodi salvestamiseks.

Loob Stripe arveldusportaali seansi maksemeetodite ja arvete haldamiseks.

Tagastab väljamakse info autenditud operaatorile.

Taotleb kogunenud teenistuse väljamakset. Minimaalne väljamakse on 10,00 EUR.

Võtab vastu Stripe webhook sündmusi. Kutsub Stripe, mitte API kliendid.

API ja selle andmebaasiühenduse tervisekontroll. Tagastab 200, kui mõlemad on korras; kui andmebaasi kontroll ebaõnnestub, tagastatakse sama struktuur, kus status ja db on seatud väärtusele error ja HTTP olekukoodiks 503.

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

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

Tagastab avaliku teabe toetatud robotimudeli kohta.

Tagastab praegused avalikud hinnaplaanid.

Esitab kontaktivormi sõnumi. Sõnum salvestatakse kõigepealt ja seejärel tarnitakse e-postiga, seega ajutine posti tõrge seda ei kaota: sellisel juhul teatab vastus stored true ja delivered false, ning tarnimist proovitakse operatiivselt uuesti.

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
}

Taotleb tuge robotitüübile, mida platvormil veel ei ole.

Tagastab avaliku platvormi statistika.