API maʼlumotnomasi

Autentifikatsiyadan oʻtgan foydalanuvchining profilini qaytaradi.

Koʻrsatiladigan nom va bildirishnoma sozlamalari kabi profil maydonlarini yangilaydi.

Supabase auth foydalanuvchisini platforma foydalanuvchi yozuvi bilan sinxronlashtiradi.

Autentifikatsiyadan oʻtgan foydalanuvchi onboardingni tugatganini bildiradi.

Autentifikatsiyadan oʻtgan foydalanuvchi uchun yangi avatar rasmini yuklaydi.

Autentifikatsiyadan oʻtgan mijoz roʻyxatga olgan robotlarni, eng yangisi birinchi boʻlib, 50 tagacha yozuvni sanaydi. Vaqt belgilari ISO 8601; robot bir marta ulanmaguncha last_online va last_heartbeat null boʻladi.

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

Yangi robotni roʻyxatga oladi va uning id sini qaytaradi. Motor plata uskuna id si faqat bitta robotga tegishli boʻlishi mumkin; toʻqnashuv 409 statusi bilan rad etiladi.

Autentifikatsiyadan oʻtgan foydalanuvchining mijoz profilini qaytaradi.

Mijoz profili maydonlarini yangilaydi.

Mijozning bulutli datasetlarini epizod soni va hajmi bilan sanaydi.

Mijozning oylik hisob-fakturalarini sanaydi.

Mijoz boshqaruv paneli uchun foydalanish statistikasini qaytaradi.

Autentifikatsiyadan oʻtgan foydalanuvchining operator profilini qaytaradi.

Operator profilini yaratadi yoki yangilaydi.

Hozir mavjud boʻlgan va operatorning sertifikatlariga mos keladigan robotlarni sanaydi.

Operatorning sertifikat soʻrovlari va ularning holatini sanaydi.

Robot turi uchun sertifikat soʻraydi.

Operatorning haftalik mavjudlik jadvalini qaytaradi.

Haftalik mavjudlik jadvalini yangilaydi.

Operatorning joriy mavjudligini qaytaradi.

Operator boshqaruv paneli uchun daromad va sessiya statistikasini qaytaradi.

Autentifikatsiyadan oʻtgan foydalanuvchi uchun sessiyalarni sanaydi. Operatorlar oʻzlari boshqargan sessiyalarni koʻradi; mijozlar oʻz robotlaridagi sessiyalarni koʻradi. Ikkala koʻrinish orasida maydon toʻplami biroz farq qiladi: mijoz koʻrinishi episodes_collected va data_collected_mb ni oʻz ichiga oladi, operator koʻrinishi esa operator_earnings_cents ni.

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

Mavjud robotda teleoperatsiya sessiyasini boshlaydi. Operator rolini talab qiladi: mijozlar sessiya boshlay olmaydi. Operator bir vaqtda koʻpi bilan bitta ACTIVE yoki PAUSED sessiyani ushlab tura oladi, robot esa hozir AVAILABLE statusiga ega boʻlishi kerak. Darhol boshlanganda robot IN_SESSION ga oʻtadi va mijozga xabar beriladi.

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

Bitta sessiyani uning tafsilotlari bilan qaytaradi.

Sessiya hayot aylanishini yangilaydi: pauza, davom ettirish, tugatish va tegishli amallar.

Sessiya uzaytirishini soʻraydi. Faqat sessiya egasi boʻlgan mijoz ushbu endpointni chaqira oladi, sessiya esa ACTIVE boʻlishi kerak. Soʻrov sessiya hodisasi sifatida qayd etiladi va operator bildirishnoma oladi; uzaytirishning oʻzi operator unga javob berganda sodir boʻladi.

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

Sessiyaning chat xabarlarini sanaydi.

Sessiyada chat xabarini yuboradi.

Tugallangan sessiyani 1 dan 5 yulduzgacha shkalada, ixtiyoriy izoh bilan baholaydi.

Sessiya maʼlumotini eksport qiladi.

Mijoz hisob-kitobi uchun ishlatiladigan Stripe mijozini yaratadi yoki qaytaradi.

Operatorning Stripe Connect hisobi holatini qaytaradi.

Operator toʻlovlari uchun Stripe Connect onboardingini boshlaydi.

Toʻlov usulini saqlash uchun Stripe SetupIntent yaratadi.

Toʻlov usullari va hisob-fakturalarni boshqarish uchun Stripe billing portal sessiyasini yaratadi.

Autentifikatsiyadan oʻtgan operator uchun toʻlov maʼlumotini qaytaradi.

Yigʻilgan daromadning toʻlovini soʻraydi. Minimal toʻlov 10,00 EUR.

Stripe webhook hodisalarini qabul qiladi. API klientlari emas, Stripe tomonidan chaqiriladi.

API va uning maʼlumotlar bazasi ulanishi uchun health-check. Ikkalasi ham yaxshi boʻlsa 200 qaytaradi; maʼlumotlar bazasi tekshiruvi muvaffaqiyatsiz boʻlsa, xuddi shu tuzilma status va db ni error ga oʻrnatilgan holda va HTTP status 503 bilan qaytariladi.

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

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

Qoʻllab-quvvatlanadigan robot modeli haqida ochiq maʼlumotni qaytaradi.

Joriy ochiq narx rejalarini qaytaradi.

Kontakt forma xabarini yuboradi. Xabar avval saqlanadi, keyin email orqali yetkaziladi, shuning uchun vaqtinchalik mail uzilishi uni yoʻqotmaydi: bunday holatda javob stored true va delivered false ni bildiradi, yetkazish esa operativ ravishda qayta urinib koʻriladi.

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
}

Platformada hali boʻlmagan robot turi uchun qoʻllab-quvvatlashni soʻraydi.

Ochiq platforma statistikasini qaytaradi.