API-referens

Returnerar profilen för den autentiserade användaren.

Uppdaterar profilfält som visningsnamnet och aviseringsinställningar.

Synkroniserar Supabase auth-användaren med plattformens användarpost.

Rapporterar om den autentiserade användaren har slutfört onboardingen.

Laddar upp en ny avatarbild för den autentiserade användaren.

Listar robotarna registrerade av den autentiserade kunden, senaste först, upp till 50 poster. Tidsstämplar är ISO 8601; last_online och last_heartbeat är null tills roboten anslutit en gång.

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

Registrerar en ny robot och returnerar dess id. Ett motorkorts hårdvaru-id kan bara tillhöra en robot; en kollision avvisas med status 409.

Returnerar kundprofilen för den autentiserade användaren.

Uppdaterar kundprofilfält.

Listar kundens molndataset med episodantal och storlekar.

Listar kundens månadsfakturor.

Returnerar användningsstatistik för kundens instrumentpanel.

Returnerar operatörsprofilen för den autentiserade användaren.

Skapar eller uppdaterar operatörsprofilen.

Listar robotar som för närvarande är tillgängliga och matchar operatörens certifieringar.

Listar operatörens certifieringsbegäranden och deras status.

Begär certifiering för en robottyp.

Returnerar operatörens veckovisa tillgänglighetsschema.

Uppdaterar det veckovisa tillgänglighetsschemat.

Returnerar operatörens aktuella tillgänglighet.

Returnerar intäkts- och sessionsstatistik för operatörens instrumentpanel.

Listar sessioner för den autentiserade användaren. Operatörer ser sessioner de opererade; kunder ser sessioner på sina robotar. Fältuppsättningen skiljer sig något mellan de två vyerna: kundvyn inkluderar episodes_collected och data_collected_mb, operatörsvyn inkluderar 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."
    }
  ]
}

Startar en teleopereringssession på en tillgänglig robot. Kräver operatörsrollen: kunder kan inte starta sessioner. En operatör kan hålla högst en ACTIVE eller PAUSED session åt gången, och roboten måste för närvarande ha status AVAILABLE. Vid en omedelbar start växlar roboten till IN_SESSION och kunden meddelas.

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

Returnerar en enskild session med dess detaljer.

Uppdaterar sessionens livscykel: pausa, återuppta, avsluta och relaterade åtgärder.

Begär en sessionsförlängning. Bara kunden som äger sessionen kan anropa den här, och sessionen måste vara ACTIVE. Begäran loggas som en sessionshändelse och operatören får en avisering; själva förlängningen sker när operatören agerar 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"
}

Listar chattmeddelandena för en session.

Skickar ett chattmeddelande i en session.

Betygsätter en avslutad session på en skala från 1 till 5 stjärnor, med en valfri kommentar.

Exporterar sessionsdata.

Skapar eller returnerar Stripe-kunden som används för kundfakturering.

Returnerar statusen för operatörens Stripe Connect-konto.

Startar Stripe Connect-onboarding för operatörsutbetalningar.

Skapar en Stripe SetupIntent för att spara en betalningsmetod.

Skapar en Stripe-faktureringsportalsession för att hantera betalningsmetoder och fakturor.

Returnerar utbetalningsinformation för den autentiserade operatören.

Begär en utbetalning av ackumulerade intäkter. Minsta utbetalning är 10,00 EUR.

Tar emot Stripe webhook-händelser. Anropas av Stripe, inte av API-klienter.

Hälsokontroll för API:et och dess databasanslutning. Returnerar 200 när båda är okej; om databaskontrollen misslyckas returneras samma form med status och db satta till error och HTTP-status 503.

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

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

Returnerar publik information om en robotmodell som stöds.

Returnerar de aktuella publika prisplanerna.

Skickar ett kontaktformulärsmeddelande. Meddelandet lagras först och levereras sedan via e-post, så ett tillfälligt mejlavbrott gör att det inte går förlorat: i så fall rapporterar svaret stored true och delivered false, och leveransen görs om operativt.

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
}

Begär stöd för en robottyp som ännu inte finns på plattformen.

Returnerar publik plattformsstatistik.