API-tilvísun

Skilar notandasniði auðkennda notandans.

Uppfærir svið notandasniðs eins og birtingarnafnið og tilkynningastillingar.

Samstillir Supabase auth-notandann við notandaskráningu kerfisins.

Segir til um hvort auðkenndi notandinn hafi lokið nýskráningu.

Hleður upp nýrri auðkennismynd fyrir auðkennda notandann.

Telur upp vélmenni skráð af auðkennda viðskiptavininum, nýjasta fyrst, allt að 50 færslur. Tímastimplar eru ISO 8601; last_online og last_heartbeat eru null þar til vélmennið hefur tengst einu sinni.

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

Skráir nýtt vélmenni og skilar auðkenni þess. Vélbúnaðarauðkenni mótorborðs getur aðeins tilheyrt einu vélmenni; árekstri er hafnað með stöðu 409.

Skilar notandasniði viðskiptavinar hjá auðkennda notandanum.

Uppfærir svið notandasniðs viðskiptavinar.

Telur upp skýjagagnasöfn viðskiptavinarins með lotufjölda og stærðum.

Telur upp mánaðarlega reikninga viðskiptavinarins.

Skilar notkunartölfræði fyrir mælaborð viðskiptavinar.

Skilar notandasniði stjórnanda hjá auðkennda notandanum.

Býr til eða uppfærir notandasnið stjórnanda.

Telur upp vélmenni sem eru laus núna og passa við vottanir stjórnandans.

Telur upp vottunarbeiðnir stjórnandans og stöðu þeirra.

Sækir um vottun fyrir vélmennitegund.

Skilar vikulegri tiltækisáætlun stjórnandans.

Uppfærir vikulegu tiltækisáætlunina.

Skilar núverandi tiltæki stjórnandans.

Skilar tekju- og setutölfræði fyrir mælaborð stjórnanda.

Telur upp setur fyrir auðkennda notandann. Stjórnendur sjá setur sem þeir stýrðu; viðskiptavinir sjá setur á sínum vélmennum. Sviðamengin eru örlítið ólík milli sýnanna tveggja: sýn viðskiptavinar inniheldur episodes_collected og data_collected_mb, sýn stjórnanda inniheldur 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."
    }
  ]
}

Ræsir fjarstýringarsetu á lausu vélmenni. Krefst stjórnandahlutverks: viðskiptavinir geta ekki ræst setur. Stjórnandi getur haldið að hámarki einni ACTIVE eða PAUSED setu í einu, og vélmennið verður að hafa stöðuna AVAILABLE. Við samstundis ræsingu skiptir vélmennið yfir í IN_SESSION og viðskiptavinurinn fær tilkynningu.

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

Skilar einni setu með smáatriðum hennar.

Uppfærir lífsferil setu: setja á bið, halda áfram, enda og tengdar aðgerðir.

Sækir um framlengingu setu. Aðeins viðskiptavinurinn sem á setuna getur kallað á þetta, og setan verður að vera ACTIVE. Beiðnin er skráð sem atburður setu og stjórnandinn fær tilkynningu; sjálf framlengingin gerist þegar stjórnandinn bregst við henni.

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

Telur upp spjallskilaboð setu.

Sendir spjallskilaboð í setu.

Gefur kláraðri setu einkunn á kvarðanum 1 til 5 stjörnur, með valfrjálsri athugasemd.

Flytur út gögn setu.

Býr til eða skilar Stripe-viðskiptavininum sem er notaður fyrir greiðslur viðskiptavinar.

Skilar stöðu Stripe Connect reiknings stjórnandans.

Ræsir Stripe Connect nýskráningu fyrir útborganir stjórnanda.

Býr til Stripe SetupIntent til að vista greiðsluaðferð.

Býr til Stripe billing portal setu til að stýra greiðsluaðferðum og reikningum.

Skilar útborgunarupplýsingum fyrir auðkennda stjórnandann.

Sækir um útborgun uppsafnaðra tekna. Lágmarksútborgun er 10,00 EUR.

Tekur við Stripe webhook-atburðum. Kallað af Stripe, ekki af API-biðlurum.

Heilbrigðisathugun fyrir API-ið og gagnagrunnstengingu þess. Skilar 200 þegar hvort tveggja er í lagi; ef gagnagrunnsathugunin mistekst kemur sama lögun til baka með status og db stillt á error og HTTP stöðu 503.

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

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

Skilar opinberum upplýsingum um studda vélmennitegund.

Skilar núverandi opinberum verðáætlunum.

Sendir inn skilaboð úr tengiliðaforminu. Skilaboðin eru fyrst vistuð og síðan afhent með tölvupósti, svo tímabundin bilun í pósti tapar þeim ekki: í því tilviki tilkynnir svarið stored true og delivered false, og afhendingin er endurtekin í rekstri.

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
}

Óskar eftir stuðningi fyrir vélmennitegund sem er ekki enn á kerfinu.

Skilar opinberri tölfræði kerfisins.