API ማጣቀሻ

የተረጋገጠውን ተጠቃሚ መገለጫ ይመልሳል።

እንደ display name እና notification preferences ያሉ የመገለጫ fields ያድሳል።

የ Supabase auth ተጠቃሚን ከመድረክ ተጠቃሚ ሪከርድ ጋር ያመሳስላል።

የተረጋገጠው ተጠቃሚ onboarding ማጠናቀቁን ያሳውቃል።

ለተረጋገጠው ተጠቃሚ አዲስ avatar ምስል ይሰቅላል።

በተረጋገጠው ደንበኛ የተመዘገቡ ሮቦቶችን ይዘረዝራል፣ አዲሱ መጀመሪያ፣ እስከ 50 entries። Timestamp ዎች 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 ውንም ይመልሳል። አንድ motor board hardware id ለአንድ ሮቦት ብቻ ሊገባ ይችላል፤ ግጭት በ status 409 ውድቅ ይደረጋል።

የተረጋገጠውን ተጠቃሚ የደንበኛ መገለጫ ይመልሳል።

የደንበኛ መገለጫ fields ያድሳል።

የደንበኛውን cloud dataset ዎች ከ episode ብዛትና መጠን ጋር ይዘረዝራል።

የደንበኛውን ወርሃዊ ደረሰኞች ይዘረዝራል።

ለደንበኛ dashboard የአጠቃቀም ስታቲስቲክስ ይመልሳል።

የተረጋገጠውን ተጠቃሚ የኦፕሬተር መገለጫ ይመልሳል።

የኦፕሬተር መገለጫ ይፈጥራል ወይም ያድሳል።

አሁን የሚገኙ ከኦፕሬተሩ ሰርተፊኬሽን ጋር የሚስማሙ ሮቦቶችን ይዘረዝራል።

የኦፕሬተሩን የሰርተፊኬሽን ጥያቄዎችና ሁኔታቸውን ይዘረዝራል።

ለሮቦት ዓይነት ሰርተፊኬት ይጠይቃል።

የኦፕሬተሩን ሳምንታዊ የመገኘት ስኬጁል ይመልሳል።

ሳምንታዊ የመገኘት ስኬጁል ያድሳል።

የኦፕሬተሩን የአሁኑን መገኘት ይመልሳል።

ለኦፕሬተር dashboard የገቢና ክፍለ ጊዜ ስታቲስቲክስ ይመልሳል።

ለተረጋገጠው ተጠቃሚ ክፍለ ጊዜዎችን ይዘረዝራል። ኦፕሬተሮች ያንቀሳቀሱባቸውን ክፍለ ጊዜዎች ያያሉ፤ ደንበኞች በሮቦቶቻቸው ላይ ያሉትን ክፍለ ጊዜዎች ያያሉ። Field set በሁለቱ views መካከል ትንሽ ይለያያል: የደንበኛ view episodes_collected እና data_collected_mb ያካትታል፣ የኦፕሬተር view ደግሞ 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 ክፍለ ጊዜ ብቻ ሊይዝ ይችላል፣ ሮቦቱም አሁን status 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 መሆን አለበት። ጥያቄው እንደ session event ይመዘገባል ኦፕሬተሩም ማስታወቂያ ይቀበላል፤ ማራዘሚያው ራሱ ኦፕሬተሩ ምላሽ ሲሰጥ ይከናወናል።

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 ኮከብ ደረጃ ላይ ይገመግማል፣ ከግዴታ ውጭ አስተያየት ጋር።

የክፍለ ጊዜ ዳታ export ያደርጋል።

ለደንበኛ ቢሊንግ የሚያገለግለውን Stripe customer ይፈጥራል ወይም ይመልሳል።

የኦፕሬተሩን Stripe Connect account ሁኔታ ይመልሳል።

ለኦፕሬተር ክፍያዎች Stripe Connect onboarding ይጀምራል።

የክፍያ ዘዴ ለማከማቸት Stripe SetupIntent ይፈጥራል።

የክፍያ ዘዴዎችንና ደረሰኞችን ለማስተዳደር Stripe billing portal session ይፈጥራል።

ለተረጋገጠው ኦፕሬተር የክፍያ መረጃ ይመልሳል።

ከተጠራቀመ ገቢ ክፍያ ይጠይቃል። ዝቅተኛው ክፍያ 10.00 EUR ነው።

የ Stripe webhook ክስተቶችን ይቀበላል። በ Stripe ይጠራል፣ በ API clients አይደለም።

ለ API ው እና ለ database ግንኙነቱ የጤና ምርመራ። ሁለቱም ደህና ሲሆኑ 200 ይመልሳል፤ database ምርመራው ቢወድቅ፣ ተመሳሳዩ ቅርጽ status እና db ን error ወደሆነ ተቀናብሮ HTTP status 503 ጋር ይመለሳል።

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

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

ስለ ተደገፈ የሮቦት ሞዴል የህዝብ መረጃ ይመልሳል።

የአሁኑን የህዝብ pricing plans ይመልሳል።

የ contact form መልዕክት ያቀርባል። መልዕክቱ መጀመሪያ ይቀመጣል ከዚያም በኢሜይል ይላካል፣ ስለዚህ ጊዜያዊ የፖስታ መቋረጥ አያጠፋውም: በዚያ ጊዜ response ው stored true እና delivered false ሪፖርት ያደርጋል፣ delivery ውም በ operational ደረጃ ደግሞ ይሞከራል።

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
}

እስካሁን በመድረኩ ላይ ላልሆነ የሮቦት ዓይነት ድጋፍ ይጠይቃል።

የህዝብ የመድረክ ስታቲስቲክስ ይመልሳል።