API-reference

Returnerer profilen for den autentificerede bruger.

Opdaterer profilfelter som visningsnavnet og notifikationspræferencer.

Synkroniserer Supabase auth-brugeren med platformens brugerpost.

Rapporterer, om den autentificerede bruger har gennemført onboarding.

Uploader et nyt avatarbillede til den autentificerede bruger.

Lister robotterne registreret af den autentificerede kunde, nyeste først, op til 50 poster. Tidsstempler er ISO 8601; last_online og last_heartbeat er null, indtil robotten har forbundet é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 dens id. Et motorkorts hardware-id kan kun tilhøre én robot; en kollision afvises med status 409.

Returnerer kundeprofilen for den autentificerede bruger.

Opdaterer kundeprofilfelter.

Lister kundens skydatasæt med episodeantal og størrelser.

Lister kundens månedlige fakturaer.

Returnerer forbrugsstatistik til kundens dashboard.

Returnerer operatørprofilen for den autentificerede bruger.

Opretter eller opdaterer operatørprofilen.

Lister robotter, der aktuelt er tilgængelige og matcher operatørens certificeringer.

Lister operatørens certificeringsanmodninger og deres status.

Anmoder om certificering til en robottype.

Returnerer operatørens ugentlige tilgængelighedsskema.

Opdaterer det ugentlige tilgængelighedsskema.

Returnerer operatørens aktuelle tilgængelighed.

Returnerer indtjenings- og sessionsstatistik til operatørens dashboard.

Lister sessioner for den autentificerede bruger. Operatører ser sessioner, de har opereret; kunder ser sessioner på deres robotter. Feltsættet adskiller sig en smule mellem de to visninger: 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 teleoperationssession på en tilgængelig robot. Kræver operatørrollen: kunder kan ikke starte sessioner. En operatør kan højst holde én ACTIVE eller PAUSED session ad gangen, og robotten skal aktuelt have status AVAILABLE. Ved en øjeblikkelig start skifter robotten til IN_SESSION, og kunden underrettes.

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 en enkelt session med dens detaljer.

Opdaterer sessionens livscyklus: pause, genoptag, afslut og relaterede handlinger.

Anmoder om en sessionsforlængelse. Kun kunden, der ejer sessionen, kan kalde dette, og sessionen skal være ACTIVE. Anmodningen logges som en sessionshændelse, og operatøren modtager en notifikation; selve forlængelsen sker, 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 chatbeskederne for en session.

Sender en chatbesked i en session.

Bedømmer en gennemført session på en skala fra 1 til 5 stjerner, med en valgfri kommentar.

Eksporterer sessionsdata.

Opretter eller returnerer den Stripe-kunde, der bruges til kundefakturering.

Returnerer status for operatørens Stripe Connect-konto.

Starter Stripe Connect-onboarding til operatørudbetalinger.

Opretter en Stripe SetupIntent til at gemme en betalingsmetode.

Opretter en Stripe-faktureringsportalsession til håndtering af betalingsmetoder og fakturaer.

Returnerer udbetalingsoplysninger for den autentificerede operatør.

Anmoder om en udbetaling af ophobet indtjening. Minimumsudbetalingen er 10,00 EUR.

Modtager Stripe webhook-hændelser. Kaldes af Stripe, ikke af API-klienter.

Sundhedstjek for API'et og dets databaseforbindelse. Returnerer 200, når begge er fine; hvis databasetjekket fejler, returneres samme form med status og db sat 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 information om en understøttet robotmodel.

Returnerer de aktuelle offentlige prisplaner.

Indsender en kontaktformularbesked. Beskeden gemmes først og leveres derefter via e-mail, så et midlertidigt mailudfald ikke mister den: i så fald rapporterer svaret stored true og delivered false, og levering forsøges igen operationelt.

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
}

Anmoder om understøttelse af en robottype, der endnu ikke findes på platformen.

Returnerer offentlig platformsstatistik.