API-referanse

Returnerer profilen til den autentiserte brukeren.

Oppdaterer profilfelt som visningsnavn og varslingspreferanser.

Synkroniserer Supabase-auth-brukeren med plattformens brukerregister.

Rapporterer om den autentiserte brukeren har fullført onboardingen.

Laster opp et nytt avatarbilde for den autentiserte brukeren.

Lister robotene registrert av den autentiserte kunden, nyeste først, opptil 50 oppføringer. Tidsstempler er ISO 8601; last_online og last_heartbeat er null til roboten har koblet til én gang.

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

Registrerer en ny robot og returnerer id-en. En motorkort-maskinvare-ID kan bare tilhøre én robot; en kollisjon avvises med status 409.

Returnerer kundeprofilen til den autentiserte brukeren.

Oppdaterer felt i kundeprofilen.

Lister kundens skydatasett med episodeantall og størrelser.

Lister kundens månedlige fakturaer.

Returnerer bruksstatistikk for kundedashbordet.

Returnerer operatørprofilen til den autentiserte brukeren.

Oppretter eller oppdaterer operatørprofilen.

Lister roboter som er tilgjengelige nå og matcher operatørens sertifiseringer.

Lister operatørens sertifiseringsforespørsler og status for dem.

Ber om sertifisering for en robottype.

Returnerer operatørens ukentlige tilgjengelighetsplan.

Oppdaterer den ukentlige tilgjengelighetsplanen.

Returnerer operatørens gjeldende tilgjengelighet.

Returnerer inntekts- og øktstatistikk for operatørdashbordet.

Lister økter for den autentiserte brukeren. Operatører ser økter de styrte; kunder ser økter på sine roboter. Feltsettet er noe forskjellig mellom de to visningene: kundevisningen inkluderer episodes_collected og data_collected_mb, operatørvisningen inkluderer 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."
    }
  ]
}

Starter en teleoperasjonsøkt på en tilgjengelig robot. Krever operatørrollen: kunder kan ikke starte økter. En operatør kan holde høyst én ACTIVE- eller PAUSED-økt om gangen, og roboten må for øyeblikket ha status AVAILABLE. Ved umiddelbar start bytter roboten til IN_SESSION og kunden varsles.

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

Returnerer én enkelt økt med detaljene dens.

Oppdaterer øktens livssyklus: pause, gjenoppta, avslutt og relaterte handlinger.

Ber om en øktforlengelse. Bare kunden som eier økten, kan kalle dette, og økten må være ACTIVE. Forespørselen logges som en økthendelse, og operatøren mottar et varsel; selve forlengelsen skjer når operatøren handler på den.

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

Lister chatmeldingene til en økt.

Sender en chatmelding i en økt.

Vurderer en fullført økt på en skala fra 1 til 5 stjerner, med en valgfri kommentar.

Eksporterer øktdata.

Oppretter eller returnerer Stripe-kunden brukt til kundefakturering.

Returnerer statusen til operatørens Stripe Connect-konto.

Starter Stripe Connect-onboardingen for operatørutbetalinger.

Oppretter en Stripe SetupIntent for å lagre en betalingsmetode.

Oppretter en Stripe-faktureringsportal-økt for å forvalte betalingsmetoder og fakturaer.

Returnerer utbetalingsinformasjon for den autentiserte operatøren.

Ber om en utbetaling av opparbeidede inntekter. Minsteutbetalingen er 10,00 EUR.

Mottar Stripe-webhook-hendelser. Kalles av Stripe, ikke av API-klienter.

Helsesjekk for API-et og databasetilkoblingen dets. Returnerer 200 når begge er i orden; feiler databasesjekken, returneres samme struktur med status og db satt til error og HTTP-status 503.

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

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

Returnerer offentlig informasjon om en støttet robotmodell.

Returnerer de gjeldende offentlige prisplanene.

Sender inn en melding fra kontaktskjemaet. Meldingen lagres først og leveres deretter på e-post, slik at et midlertidig e-postavbrudd ikke mister den: i så fall rapporterer svaret stored true og delivered false, og leveringen forsøkes på nytt driftsmessig.

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
}

Ber om støtte for en robottype som ikke er på plattformen ennå.

Returnerer offentlig plattformstatistikk.