API-referentie

Geeft het profiel van de geauthenticeerde gebruiker terug.

Werkt profielvelden bij, zoals de weergavenaam en de meldingsvoorkeuren.

Synchroniseert de Supabase-authgebruiker met het platformgebruikersrecord.

Meldt of de geauthenticeerde gebruiker de onboarding heeft voltooid.

Uploadt een nieuwe avatarafbeelding voor de geauthenticeerde gebruiker.

Toont de door de geauthenticeerde klant geregistreerde robots, nieuwste eerst, tot 50 items. Tijdstempels zijn ISO 8601; last_online en last_heartbeat zijn null totdat de robot ooit verbinding heeft gemaakt.

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

Registreert een nieuwe robot en geeft zijn id terug. Een hardware-id van een motorbord kan bij slechts één robot horen; een botsing wordt geweigerd met status 409.

Geeft het klantprofiel van de geauthenticeerde gebruiker terug.

Werkt velden van het klantprofiel bij.

Toont de clouddatasets van de klant met episodetallen en groottes.

Toont de maandelijkse facturen van de klant.

Geeft gebruiksstatistieken terug voor het klantdashboard.

Geeft het operatorprofiel van de geauthenticeerde gebruiker terug.

Maakt het operatorprofiel aan of werkt het bij.

Toont robots die momenteel beschikbaar zijn en passen bij de certificeringen van de operator.

Toont de certificeringsaanvragen van de operator en hun status.

Vraagt certificering voor een robottype aan.

Geeft het wekelijkse beschikbaarheidsschema van de operator terug.

Werkt het wekelijkse beschikbaarheidsschema bij.

Geeft de huidige beschikbaarheid van de operator terug.

Geeft verdienste- en sessiestatistieken terug voor het operatordashboard.

Toont sessies voor de geauthenticeerde gebruiker. Operators zien sessies die zij bestuurden; klanten zien sessies op hun robots. De veldenset verschilt licht tussen de twee weergaven: de klantweergave bevat episodes_collected en data_collected_mb, de operatorweergave bevat 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."
    }
  ]
}

Start een teleoperatiesessie op een beschikbare robot. Vereist de operatorrol: klanten kunnen geen sessies starten. Een operator kan hoogstens één ACTIVE- of PAUSED-sessie tegelijk houden, en de robot moet momenteel de status AVAILABLE hebben. Bij een directe start schakelt de robot over naar IN_SESSION en wordt de klant op de hoogte gebracht.

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

Geeft één sessie met haar details terug.

Werkt de sessielevenscyclus bij: pauzeren, hervatten, beëindigen en gerelateerde acties.

Vraagt een sessieverlenging aan. Alleen de klant die de sessie bezit, kan dit endpoint aanroepen, en de sessie moet ACTIVE zijn. Het verzoek wordt vastgelegd als een sessiegebeurtenis en de operator ontvangt een melding; de verlenging zelf gebeurt wanneer de operator erop reageert.

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

Toont de chatberichten van een sessie.

Verstuurt een chatbericht in een sessie.

Beoordeelt een voltooide sessie op een schaal van 1 tot 5 sterren, met een optioneel commentaar.

Exporteert sessiedata.

Maakt de Stripe-klant aan die voor klantfacturatie wordt gebruikt, of geeft deze terug.

Geeft de status van het Stripe Connect-account van de operator terug.

Start de Stripe Connect-onboarding voor uitbetalingen aan operators.

Maakt een Stripe SetupIntent aan voor het opslaan van een betaalmethode.

Maakt een Stripe-facturatieportaalsessie aan voor het beheren van betaalmethoden en facturen.

Geeft uitbetalingsinformatie terug voor de geauthenticeerde operator.

Vraagt een uitbetaling van de opgebouwde verdiensten aan. De minimale uitbetaling is 10,00 EUR.

Ontvangt Stripe-webhookgebeurtenissen. Wordt door Stripe aangeroepen, niet door API-clients.

Health check voor de API en haar databaseverbinding. Geeft 200 terug wanneer beide in orde zijn; faalt de databasecontrole, dan wordt dezelfde structuur teruggegeven met status en db op error en HTTP-status 503.

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

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

Geeft publieke informatie over een ondersteund robotmodel terug.

Geeft de huidige publieke prijsabonnementen terug.

Dient een bericht van het contactformulier in. Het bericht wordt eerst opgeslagen en daarna per e-mail bezorgd, zodat een tijdelijke mailstoring het niet verliest: in dat geval meldt de response stored true en delivered false, en wordt de bezorging operationeel opnieuw geprobeerd.

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
}

Vraagt ondersteuning aan voor een robottype dat nog niet op het platform staat.

Geeft publieke platformstatistieken terug.