API лавлах

Нэвтрэлт баталгаажуулагдсан хэрэглэгчийн профайлыг буцаана.

Харагдах нэр, мэдэгдлийн тохиргоо зэрэг профайлын талбаруудыг шинэчилдэг.

Supabase auth хэрэглэгчийг платформын хэрэглэгчийн бичлэгтэй синхрончилдог.

Нэвтрэлт баталгаажуулагдсан хэрэглэгч бүртгэлээ дуусгасан эсэхийг мэдээлдэг.

Нэвтрэлт баталгаажуулагдсан хэрэглэгчид зориулж шинэ аватар зураг байршуулдаг.

Нэвтрэлт баталгаажуулагдсан үйлчлүүлэгчийн бүртгэсэн роботуудыг, хамгийн шинэ нь эхэнд, 50 хүртэлх бичлэгээр жагсаана. Цаг тэмдэгүүд ISO 8601; робот нэг удаа холбогдтол last_online, last_heartbeat null байна.

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

Шинэ роботыг бүртгэж, түүний id-г буцаадаг. Мотор платын техник хангамжийн id зөвхөн нэг роботод харьяалагдаж болно; давхцлыг 409 статусаар татгалздаг.

Нэвтрэлт баталгаажуулагдсан хэрэглэгчийн үйлчлүүлэгчийн профайлыг буцаана.

Үйлчлүүлэгчийн профайлын талбаруудыг шинэчилдэг.

Үйлчлүүлэгчийн үүлэн өгөгдлийн багцуудыг эпизодын тоо, хэмжээтэй нь жагсаана.

Үйлчлүүлэгчийн сарын нэхэмжлэхүүдийг жагсаана.

Үйлчлүүлэгчийн хянах самбарт зориулсан ашиглалтын статистикийг буцаана.

Нэвтрэлт баталгаажуулагдсан хэрэглэгчийн операторын профайлыг буцаана.

Операторын профайлыг үүсгэдэг эсвэл шинэчилдэг.

Одоо боломжтой бөгөөд операторын гэрчилгээтэй тохирох роботуудыг жагсаана.

Операторын гэрчилгээний хүсэлтүүд болон тэдгээрийн төлөвийг жагсаана.

Роботын төрлийн гэрчилгээ хүсдэг.

Операторын долоо хоногийн боломжтой байдлын хуваарийг буцаана.

Долоо хоногийн боломжтой байдлын хуваарийг шинэчилдэг.

Операторын одоогийн боломжтой байдлыг буцаана.

Операторын хянах самбарт зориулсан орлого, сешний статистикийг буцаана.

Нэвтрэлт баталгаажуулагдсан хэрэглэгчид зориулж сешнүүдийг жагсаана. Операторууд өөрсдийн удирдсан сешнүүдийг харна; үйлчлүүлэгчид өөрсдийн роботууд дээрх сешнүүдийг харна. Хоёр харагдацын хооронд талбарын багц бага зэрэг ялгаатай: үйлчлүүлэгчийн харагдац episodes_collected, data_collected_mb-г, операторын харагдац 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."
    }
  ]
}

Боломжтой робот дээр телеудирдлагын сешн эхлүүлдэг. Операторын эрх шаардана: үйлчлүүлэгчид сешн эхлүүлж чадахгүй. Оператор нэг зэрэг хамгийн ихдээ нэг ACTIVE эсвэл PAUSED сешнийг ажиллуулж чадна, робот одоо AVAILABLE статустай байх ёстой. Шууд эхлэхэд робот IN_SESSION болж, үйлчлүүлэгчид мэдэгдэл очно.

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

Дэлгэрэнгүйтэй нь нэг сешнийг буцаана.

Сешний амьдралын мөчлөгийг шинэчилдэг: түр зогсоох, үргэлжлүүлэх, дуусгах болон холбогдох үйлдлүүд.

Сешн сунгах хүсэлт илгээдэг. Зөвхөн сешнийг эзэмшигч үйлчлүүлэгч энэ эндпойнтыг дуудаж чадна, сешн ACTIVE байх ёстой. Хүсэлт сешний үйл явдал болж тэмдэглэгдэж, оператор мэдэгдэл авдаг; сунгалт өөрөө оператор түүнд хариу үйлдэл үзүүлэхэд болдог.

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

Сешний чат мессежүүдийг жагсаана.

Сешнд чат мессеж илгээдэг.

Дууссан сешнийг 1-ээс 5 одоны шкалаар, сонголттой сэтгэгдэлтэй үнэлдэг.

Сешний өгөгдлийг экспортлодог.

Үйлчлүүлэгчийн төлбөр тооцоонд ашиглагдах Stripe үйлчлүүлэгчийг үүсгэдэг эсвэл буцаадаг.

Операторын Stripe Connect дансны төлөвийг буцаана.

Операторын төлбөрт зориулсан Stripe Connect бүртгэлийг эхлүүлдэг.

Төлбөрийн аргыг хадгалахын тулд Stripe SetupIntent үүсгэдэг.

Төлбөрийн арга, нэхэмжлэхийг удирдахад зориулсан Stripe billing portal сешн үүсгэдэг.

Нэвтрэлт баталгаажуулагдсан операторын төлбөрийн мэдээллийг буцаана.

Хуримтлагдсан орлогын төлбөр гаргах хүсэлт илгээдэг. Хамгийн бага төлбөр 10,00 EUR.

Stripe webhook үйл явдлуудыг хүлээн авдаг. API клиент биш, Stripe-аас дуудагддаг.

API болон түүний өгөгдлийн сангийн холболтын health-check. Хоёулаа хэвийн бол 200 буцаана; өгөгдлийн сангийн шалгалт амжилтгүй бол status, db-г error болгосон ижил бүтэц, HTTP статус 503-тай буцна.

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

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

Дэмжигддэг роботын загварын нийтийн мэдээллийг буцаана.

Одоогийн нийтийн үнийн төлөвлөгөөнүүдийг буцаана.

Холбоо барих маягтын мессежийг илгээдэг. Мессеж эхлээд хадгалагдаж, дараа нь имэйлээр хүргэгддэг тул түр зуурын мэйл тасалдал үүнийг алддаггүй: тэр тохиолдолд хариулт stored true, delivered false гэж мэдээлдэг, хүргэлт нь ажиллагааны хувьд дахин оролдогддог.

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
}

Платформ дээр хараахан байхгүй роботын төрөлд дэмжлэг хүсдэг.

Нийтийн платформын статистикийг буцаана.