API-verwysing

Gee die profiel van die geverifieerde gebruiker terug.

Werk profielvelde by, soos die vertoonnaam en kennisgewingvoorkeure.

Sinchroniseer die Supabase-verifikasiegebruiker met die platformgebruikersrekord.

Rapporteer of die geverifieerde gebruiker onboarding voltooi het.

Laai 'n nuwe avatarbeeld op vir die geverifieerde gebruiker.

Lys die robotte wat deur die geverifieerde kliënt geregistreer is, nuutste eerste, tot 50 inskrywings. Tydstempels is ISO 8601; last_online en last_heartbeat is null totdat die robot een keer gekoppel het.

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

Registreer 'n nuwe robot en gee sy id terug. 'n Motorbord-hardeware-id kan aan slegs een robot behoort; 'n botsing word verwerp met status 409.

Gee die kliëntprofiel van die geverifieerde gebruiker terug.

Werk kliëntprofielvelde by.

Lys die kliënt se wolkdatastelle met episodetellings en groottes.

Lys die kliënt se maandelikse fakture.

Gee gebruikstatistieke vir die kliëntdashboard terug.

Gee die operateurprofiel van die geverifieerde gebruiker terug.

Skep of werk die operateurprofiel by.

Lys robotte wat tans beskikbaar is en by die operateur se sertifisering pas.

Lys die operateur se sertifiseringsaanvrae en hul status.

Vra sertifisering vir 'n robottipe aan.

Gee die operateur se weeklikse beskikbaarheidskedule terug.

Werk die weeklikse beskikbaarheidskedule by.

Gee die operateur se huidige beskikbaarheid terug.

Gee verdienste- en sessiestatistieke vir die operateurdashboard terug.

Lys sessies vir die geverifieerde gebruiker. Operateurs sien sessies wat hulle bedien het; kliënte sien sessies op hul robotte. Die veldstel verskil effens tussen die twee aansigte: die kliëntaansig sluit episodes_collected en data_collected_mb in, die operateuraansig sluit operator_earnings_cents in.

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

Begin 'n teleoperasie-sessie op 'n beskikbare robot. Vereis die operateurrol: kliënte kan nie sessies begin nie. 'n Operateur kan hoogstens een ACTIVE- of PAUSED-sessie op 'n slag hou, en die robot moet tans status AVAILABLE hê. By 'n onmiddellike begin skakel die robot na IN_SESSION en die kliënt word ingelig.

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

Gee 'n enkele sessie met sy besonderhede terug.

Werk die sessielewensiklus by: pouseer, hervat, beëindig, en verwante aksies.

Vra 'n sessieverlenging aan. Slegs die kliënt wat die sessie besit, kan dit aanroep, en die sessie moet ACTIVE wees. Die aanvraag word as 'n sessiegebeurtenis geregistreer en die operateur ontvang 'n kennisgewing; die verlenging self gebeur wanneer die operateur daarop reageer.

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

'n Sessie se kletsboodskappe lys.

'n Kletsboodskap in 'n sessie stuur.

'n Voltooide sessie op 'n skaal van 1 tot 5 sterre gradeer, met 'n opsionele opmerking.

Voer sessiedata uit.

Skep of gee die Stripe-kliënt terug wat vir kliëntfakturering gebruik word.

Gee die status van die operateur se Stripe Connect-rekening terug.

Begin Stripe Connect-onboarding vir operateuruitbetalings.

Skep 'n Stripe SetupIntent om 'n betaalmetode te stoor.

Skep 'n Stripe billing portal-sessie om betaalmetodes en fakture te bestuur.

Gee uitbetalinginligting vir die geverifieerde operateur terug.

Vra 'n uitbetaling van opgehoopte verdienste aan. Die minimum uitbetaling is 10,00 EUR.

Ontvang Stripe-webhookgebeure. Word deur Stripe aangeroep, nie deur API-kliënte nie.

Gesondheidstoets vir die API en sy databasiskoppeling. Gee 200 terug wanneer albei in orde is; as die databasistoets faal, word dieselfde vorm teruggegee 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"
}

Gee openbare inligting oor 'n ondersteunde robotmodel terug.

Gee die huidige openbare prysplanne terug.

Dien 'n kontakvormboodskap in. Die boodskap word eers gestoor en dan per e-pos afgelewer, sodat 'n tydelike posonderbreking dit nie verloor nie: in daardie geval rapporteer die respons stored true en delivered false, en aflewering word operasioneel herprobeer.

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
}

Vra ondersteuning aan vir 'n robottipe wat nog nie op die platform is nie.

Gee openbare platformstatistieke terug.