API-referencia

Visszaadja a hitelesített felhasználó profilját.

Frissíti a profilmezőket, például a megjelenítendő nevet és az értesítési beállításokat.

Szinkronizálja a Supabase Auth felhasználót a platform felhasználói rekordjával.

Jelenti, hogy a hitelesített felhasználó befejezte-e az onboardingot.

Feltölt egy új avatárképet a hitelesített felhasználó számára.

Felsorolja a hitelesített ügyfél által regisztrált robotokat, legújabb elöl, legfeljebb 50 bejegyzésig. Az időbélyegek ISO 8601 formátumúak; a last_online és a last_heartbeat null, amíg a robot egyszer sem csatlakozott.

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

Regisztrál egy új robotot, és visszaadja az id-jét. Egy motorpanel hardver-id-je csak egyetlen robothoz tartozhat; egy ütközés 409-es státusszal elutasításra kerül.

Visszaadja a hitelesített felhasználó ügyfélprofilját.

Frissíti az ügyfélprofil mezőit.

Felsorolja az ügyfél felhő-adatkészleteit epizódszámmal és mérettel.

Felsorolja az ügyfél havi számláit.

Visszaadja a használati statisztikákat az ügyfél-irányítópulthoz.

Visszaadja a hitelesített felhasználó operátori profilját.

Létrehozza vagy frissíti az operátori profilt.

Felsorolja az éppen elérhető és az operátor minősítéseinek megfelelő robotokat.

Felsorolja az operátor minősítési kérelmeit és azok állapotát.

Minősítést kér egy robottípushoz.

Visszaadja az operátor heti elérhetőségi beosztását.

Frissíti a heti elérhetőségi beosztást.

Visszaadja az operátor jelenlegi elérhetőségét.

Visszaadja a kereset- és munkamenet-statisztikákat az operátor-irányítópulthoz.

Felsorolja a hitelesített felhasználó munkameneteit. Az operátorok azokat a munkameneteket látják, amelyeket ők vezettek; az ügyfelek a saját robotjaikon futottakat. A mezőkészlet kissé eltér a két nézet között: az ügyfélnézet tartalmazza az episodes_collected és a data_collected_mb mezőket, az operátori nézet az operator_earnings_cents mezőt.

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

Elindít egy teleoperációs munkamenetet egy elérhető robotnál. Operátor szerepkört igényel: ügyfelek nem indíthatnak munkamenetet. Egy operátor egyszerre legfeljebb egy ACTIVE vagy PAUSED munkamenetet tarthat, és a robotnak jelenleg AVAILABLE állapotúnak kell lennie. Azonnali indításnál a robot IN_SESSION állapotra vált, és az ügyfél értesítést kap.

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

Visszaad egyetlen munkamenetet a részleteivel.

Frissíti a munkamenet életciklusát: szüneteltetés, folytatás, befejezés és kapcsolódó műveletek.

Munkamenet-hosszabbítást kér. Ezt csak az az ügyfél hívhatja meg, akié a munkamenet, és a munkamenetnek ACTIVE állapotúnak kell lennie. A kérés munkamenet-eseményként kerül naplózásra, és az operátor értesítést kap; maga a hosszabbítás akkor történik meg, amikor az operátor reagál rá.

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

Felsorolja egy munkamenet chatüzeneteit.

Chatüzenetet küld egy munkamenetben.

Egy befejezett munkamenetet 1-től 5 csillagig terjedő skálán értékel, opcionális megjegyzéssel.

Exportálja a munkamenet adatait.

Létrehozza vagy visszaadja az ügyfélszámlázáshoz használt Stripe ügyfelet.

Visszaadja az operátor Stripe Connect fiókjának állapotát.

Elindítja a Stripe Connect onboardingot az operátori kifizetésekhez.

Létrehoz egy Stripe SetupIntentet egy fizetési mód mentéséhez.

Létrehoz egy Stripe billing portál munkamenetet a fizetési módok és számlák kezeléséhez.

Visszaadja a hitelesített operátor kifizetési adatait.

Kifizetést kér a felhalmozott keresetekből. A minimum kifizetés 10,00 EUR.

Fogadja a Stripe webhook eseményeit. A Stripe hívja, nem az API kliensei.

Állapotellenőrzés az API-hoz és annak adatbázis-kapcsolatához. 200-at ad vissza, ha minden rendben; ha az adatbázis-ellenőrzés sikertelen, ugyanaz az alak érkezik vissza, a status és a db mezővel error-ra állítva, 503-as HTTP státusszal.

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

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

Visszaad nyilvános információt egy támogatott robotmodellről.

Visszaadja az aktuális nyilvános árazási csomagokat.

Beküld egy kapcsolatfelvételi űrlap üzenetet. Az üzenet előbb tárolásra kerül, majd e-mailben kézbesítik, így egy átmeneti levélkiesés nem veszíti el: ebben az esetben a válasz stored true és delivered false értéket jelent, és a kézbesítést üzemeltetői oldalon újrapróbálják.

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
}

Támogatást kér egy még nem szereplő robottípushoz a platformon.

Visszaadja a nyilvános platformstatisztikákat.