API reference

מחזיר את הפרופיל של המשתמש המאומת.

מעדכן שדות פרופיל כמו שם התצוגה והעדפות התראות.

מסנכרן את משתמש ה-auth של Supabase עם רשומת המשתמש בפלטפורמה.

מדווח האם המשתמש המאומת השלים onboarding.

מעלה תמונת avatar חדשה עבור המשתמש המאומת.

מציג את הרובוטים הרשומים על ידי הלקוח המאומת, החדשים ביותר תחילה, עד 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 שלו. hardware id של לוח מנוע יכול להשתייך לרובוט אחד בלבד; התנגשות נדחית עם סטטוס 409.

מחזיר את פרופיל הלקוח של המשתמש המאומת.

מעדכן שדות פרופיל לקוח.

מציג את מערכי הנתונים בענן של הלקוח עם ספירות episodes וגדלים.

מציג את החשבוניות החודשיות של הלקוח.

מחזיר סטטיסטיקות שימוש עבור לוח הבקרה של הלקוח.

מחזיר את פרופיל המפעיל של המשתמש המאומת.

יוצר או מעדכן את פרופיל המפעיל.

מציג רובוטים שזמינים כרגע ותואמים להסמכות של המפעיל.

מציג את בקשות ההסמכה של המפעיל ואת הסטטוס שלהן.

מבקש הסמכה עבור סוג רובוט.

מחזיר את לוח הזמינות השבועי של המפעיל.

מעדכן את לוח הזמינות השבועי.

מחזיר את הזמינות הנוכחית של המפעיל.

מחזיר סטטיסטיקות רווחים והפעלות עבור לוח הבקרה של המפעיל.

מציג הפעלות עבור המשתמש המאומת. מפעילים רואים הפעלות שהם הפעילו; לקוחות רואים הפעלות על הרובוטים שלהם. קבוצת השדות שונה מעט בין שתי התצוגות: תצוגת הלקוח כוללת 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 של המפעיל.

מתחיל onboarding של Stripe Connect עבור משיכות מפעילים.

יוצר Stripe SetupIntent לשמירת אמצעי תשלום.

יוצר הפעלת פורטל חיוב של Stripe לניהול אמצעי תשלום וחשבוניות.

מחזיר מידע משיכה עבור המפעיל המאומת.

מבקש משיכה של רווחים שנצברו. המשיכה המינימלית היא 10.00 EUR.

מקבל אירועי webhook של Stripe. נקרא על ידי Stripe, לא על ידי לקוחות API.

בדיקת תקינות עבור ה-API וחיבור מסד הנתונים שלו. מחזיר 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
}

מבקש תמיכה עבור סוג רובוט שעדיין לא בפלטפורמה.

מחזיר סטטיסטיקות פלטפורמה ציבוריות.