API-viite

Palauttaa todennetun käyttäjän profiilin.

Päivittää profiilikenttiä, kuten näyttönimen ja ilmoitusasetukset.

Synkronoi Supabase-todennuskäyttäjän alustan käyttäjätietueen kanssa.

Kertoo, onko todennettu käyttäjä suorittanut käyttöönoton loppuun.

Lataa uuden avatarkuvan todennetulle käyttäjälle.

Listaa todennetun asiakkaan rekisteröimät robotit, uusimmat ensin, enintään 50 merkintää. Aikaleimat ovat ISO 8601 -muodossa; last_online ja last_heartbeat ovat null, kunnes robotti on yhdistänyt kerran.

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

Rekisteröi uuden robotin ja palauttaa sen id:n. Moottorikortin laitteisto-id voi kuulua vain yhdelle robotille; törmäys hylätään tilalla 409.

Palauttaa todennetun käyttäjän asiakasprofiilin.

Päivittää asiakasprofiilin kenttiä.

Listaa asiakkaan pilvidatasetit episodimäärineen ja kokoineen.

Listaa asiakkaan kuukausilaskut.

Palauttaa käyttötilastot asiakkaan dashboardille.

Palauttaa todennetun käyttäjän operaattoriprofiilin.

Luo tai päivittää operaattoriprofiilin.

Listaa robotit, jotka ovat parhaillaan saatavilla ja vastaavat operaattorin sertifiointeja.

Listaa operaattorin sertifiointipyynnöt ja niiden tilan.

Pyytää sertifiointia robottityypille.

Palauttaa operaattorin viikoittaisen saatavuusaikataulun.

Päivittää viikoittaisen saatavuusaikataulun.

Palauttaa operaattorin nykyisen saatavuuden.

Palauttaa ansio- ja istuntotilastot operaattorin dashboardille.

Listaa todennetun käyttäjän istunnot. Operaattorit näkevät istunnot, joita he ovat ohjanneet; asiakkaat näkevät istunnot omilla roboteillaan. Kenttäjoukko eroaa hieman näiden kahden näkymän välillä: asiakasnäkymä sisältää kentät episodes_collected ja data_collected_mb, operaattorinäkymä sisältää kentän 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."
    }
  ]
}

Käynnistää teleoperointi-istunnon käytettävissä olevalla robotilla. Vaatii operaattorin roolin: asiakkaat eivät voi käynnistää istuntoja. Operaattorilla voi olla kerrallaan enintään yksi ACTIVE- tai PAUSED-istunto, ja robotin tilan täytyy tällä hetkellä olla AVAILABLE. Välittömässä käynnistyksessä robotti vaihtuu tilaan IN_SESSION ja asiakkaalle ilmoitetaan.

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

Palauttaa yksittäisen istunnon tietoineen.

Päivittää istunnon elinkaarta: keskeytys, jatkaminen, lopetus ja niihin liittyvät toiminnot.

Pyytää istunnon jatkoa. Vain istunnon omistava asiakas voi kutsua tätä, ja istunnon täytyy olla ACTIVE. Pyyntö kirjataan istuntotapahtumana, ja operaattori saa ilmoituksen; itse jatko tapahtuu, kun operaattori toimii sen mukaisesti.

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

Listaa istunnon chat-viestit.

Lähettää chat-viestin istunnossa.

Arvioi suoritetun istunnon asteikolla 1-5 tähteä, valinnaisella kommentilla.

Vie istuntodataa.

Luo tai palauttaa asiakaslaskutukseen käytettävän Stripe-asiakkaan.

Palauttaa operaattorin Stripe Connect -tilin tilan.

Käynnistää Stripe Connect -käyttöönoton operaattorimaksuja varten.

Luo Stripe SetupIntentin maksutavan tallentamista varten.

Luo Stripe-laskutusportaali-istunnon maksutapojen ja laskujen hallintaan.

Palauttaa todennetun operaattorin maksutiedot.

Pyytää kertyneiden ansioiden maksua. Vähimmäismaksu on 10,00 EUR.

Vastaanottaa Stripen webhook-tapahtumat. Stripen kutsuma, ei API-asiakkaiden.

API:n ja sen tietokantayhteyden terveystarkistus. Palauttaa 200, kun molemmat ovat kunnossa; jos tietokantatarkistus epäonnistuu, palautetaan sama muoto status- ja db-kentillä arvona error sekä HTTP-tilalla 503.

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

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

Palauttaa julkista tietoa tuetusta robottimallista.

Palauttaa nykyiset julkiset hinnoittelusuunnitelmat.

Lähettää yhteydenottolomakkeen viestin. Viesti tallennetaan ensin ja toimitetaan sitten sähköpostitse, joten tilapäinen sähköpostikatkos ei hukkaa sitä: siinä tapauksessa vastaus ilmoittaa stored true ja delivered false, ja toimitusta yritetään uudelleen operatiivisesti.

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
}

Pyytää tukea robottityypille, joka ei vielä ole alustalla.

Palauttaa julkiset alustan tilastot.