Referenca API

Kthen profilin e përdoruesit të autentikuar.

Përditëson fushat e profilit, si emri i shfaqur dhe preferencat e njoftimeve.

Sinkronizon përdoruesin e autentikimit Supabase me rekordin e përdoruesit të platformës.

Raporton nëse përdoruesi i autentikuar e ka përfunduar onboarding-un.

Ngarkon një imazh të ri avatari për përdoruesin e autentikuar.

Liston robotët e regjistruar nga klienti i autentikuar, më të rejtë së pari, deri në 50 hyrje. Vulat kohore janë ISO 8601; last_online dhe last_heartbeat janë null derisa roboti të jetë lidhur të paktën një herë.

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

Regjistron një robot të ri dhe kthen id-në e tij. Një hardware id i një bordi motori mund t'i përkasë vetëm një roboti; një përplasje refuzohet me statusin 409.

Kthen profilin e klientit të përdoruesit të autentikuar.

Përditëson fushat e profilit të klientit.

Liston dataset-et e klientit në cloud me numrin e episodeve dhe madhësitë.

Liston faturat mujore të klientit.

Kthen statistika përdorimi për panelin e klientit.

Kthen profilin e operatorit të përdoruesit të autentikuar.

Krijon ose përditëson profilin e operatorit.

Liston robotët aktualisht të disponueshëm që përputhen me certifikimet e operatorit.

Liston kërkesat e certifikimit të operatorit dhe statusin e tyre.

Kërkon certifikim për një tip roboti.

Kthen orarin javor të disponueshmërisë të operatorit.

Përditëson orarin javor të disponueshmërisë.

Kthen disponueshmërinë aktuale të operatorit.

Kthen statistika fitimesh dhe sesionesh për panelin e operatorit.

Liston sesionet për përdoruesin e autentikuar. Operatorët shohin sesionet që kanë operuar; klientët shohin sesionet mbi robotët e tyre. Bashkësia e fushave dallon pak mes dy pamjeve: pamja e klientit përfshin episodes_collected dhe data_collected_mb, pamja e operatorit përfshin 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."
    }
  ]
}

Nis një sesion teleoperimi mbi një robot të disponueshëm. Kërkon rolin operator: klientët nuk mund të nisin sesione. Një operator mund të mbajë më së shumti një sesion ACTIVE ose PAUSED njëherësh, dhe roboti duhet të ketë aktualisht statusin AVAILABLE. Në një nisje të menjëhershme roboti kalon në IN_SESSION dhe klienti njoftohet.

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

Kthen një sesion të vetëm me detajet e tij.

Përditëson ciklin e jetës së sesionit: pauzë, rifillim, përfundim dhe veprime të lidhura.

Kërkon një zgjatje sesioni. Vetëm klienti që zotëron sesionin mund ta thërrasë këtë, dhe sesioni duhet të jetë ACTIVE. Kërkesa regjistrohet si një ngjarje sesioni dhe operatori merr një njoftim; vetë zgjatja ndodh kur operatori vepron mbi të.

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

Liston mesazhet e bisedës së një sesioni.

Dërgon një mesazh në bisedën e një sesioni.

Vlerëson një sesion të përfunduar në një shkallë 1 deri në 5 yje, me një koment opsional.

Eksporton të dhëna sesioni.

Krijon ose kthen klientin Stripe të përdorur për faturimin e klientit.

Kthen statusin e llogarisë Stripe Connect të operatorit.

Nis onboarding-un e Stripe Connect për pagesat e operatorit.

Krijon një Stripe SetupIntent për ruajtjen e një metode pagese.

Krijon një sesion Stripe billing portal për menaxhimin e metodave të pagesës dhe faturave.

Kthen informacione pagese për operatorin e autentikuar.

Kërkon një pagesë të fitimeve të grumbulluara. Pagesa minimale është 10,00 EUR.

Merr ngjarje webhook nga Stripe. Thirret nga Stripe, jo nga klientë API.

Kontroll shëndeti për API-në dhe lidhjen e saj me bazën e të dhënave. Kthen 200 kur të dyja janë në rregull; nëse kontrolli i bazës së të dhënave dështon, kthehet e njëjta formë me status dhe db të vendosura në error dhe statusin HTTP 503.

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

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

Kthen informacion publik për një model roboti të mbështetur.

Kthen planet aktuale publike të çmimeve.

Dërgon një mesazh përmes formularit të kontaktit. Mesazhi ruhet së pari dhe pastaj dorëzohet me email, kështu që një ndërprerje e përkohshme e postës nuk e humb: në atë rast përgjigja raporton stored true dhe delivered false, dhe dorëzimi riprovohet operacionalisht.

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
}

Kërkon mbështetje për një tip roboti që ende nuk është në platformë.

Kthen statistika publike të platformës.