🏠 מה תלמד בהדרכה זו?

בסיום ההדרכה תדע כיצד:

• לפתוח ממשק Swagger ולנווט בו
• ליצור רשומת ועדה חדשה ולקבל meetingId
• להעלות קובץ בתהליך מחולק לשלבים
• לעקוב אחר עיבוד ה-AI ולדעת מתי הוא הסתיים
• לצפות בסיכום שנוצר אוטומטית
• להוריד קובץ Word / PDF מוכן לשיתוף

🔍 איך עובד Swagger — מבוא מהיר

Swagger הוא ממשק ויזואלי שמאפשר לך לקרוא לכל endpoint של ה-API ישירות מהדפדפן — בלי לכתוב שורת קוד. כל ה-HTTP Requests מתבצעות בזמן אמת לשרת האמיתי.

זרימת העבודה הטיפוסית

1. מרחיב endpoint ברשימה (לחיצה על השם)
2. לוחץ Try it out
3. ממלא / מדביק את ה-JSON בתיבה
4. לוחץ Execute
5. מגלל למטה ל-Server response ומעתיק את הערך הרלוונטי

💚 שלב 0 — בדיקת חיבור לשרת

{
  "status": "ok",
  "message": "Server is running healthy"
}

נתקלת בשגיאה? עברו לתקלות נפוצות ←

📋 שלב 1 — יצירת רשומת ועדה

{
  "performedBy": "test@example.com"
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "DRAFT",
  "currentStep": 0
}

נתקלת בשגיאה? עברו לתקלות נפוצות ←

📁 שלבים 2–4 — העלאת קובץ להקלטה

תהליך ההעלאה מורכב מ-3 קריאות API: start → part → complete. עבור קבצים קטנים (עד 5MB) שולחים חלק אחד בלבד.

{
  "meetingId":  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "currentStep": 4,
  "fileName":   "test.txt",
  "fileSize":   30,
  "performedBy": "test@example.com"
}

{
  "uploadId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
  "status": "initialized"
}

{
  "status": "success",
  "receivedPart": 1,
  "message": "Part accepted"
}

{
  "uploadId":   "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
  "meetingId":  "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "totalParts": 1,
  "currentStep": 4,
  "performedBy": "test@example.com"
}

{
  "status": "processing",
  "processId": "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
  "message": "File assembly complete. AI summary generation started."
}

נתקלת בשגיאה? עברו לתקלות נפוצות ←

⏳ שלב 5 — מעקב אחר עיבוד ה-AI

לאחר /complete, השרת מריץ ברקע תמלול + יצירת סיכום. תהליך זה עשוי לקחת מספר דקות. ניתן לבדוק את ההתקדמות.

{
  "meetingId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "processId": "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
  "percentage": 65,
  "estimatedTimeRemaining": "2 minutes",
  "statusMessage": "Transcribing audio..."
}

נתקלת בשגיאה? עברו לתקלות נפוצות ←

📄 שלב 6 — צפייה בסיכום שנוצר

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "READY_FOR_EDIT",  // ← זה מה שאנחנו מחפשים
  "aiContent": {
    "htmlContent": "<h1>סיכום וועדה...</h1>",  // ← הסיכום
    "isEditedByUser": false,
    "lastGenerated": "2026-05-27T10:00:00Z"
  },
  "filesStatus": {
    "processingActive": false,  // ← false = עיבוד הסתיים
    "recordingReady": true
  }
}

נתקלת בשגיאה? עברו לתקלות נפוצות ←

⬇️ שלב 7 — יצוא והורדת Word / PDF

{
  "meetingId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "files": [
    {
      "format": "WORD",
      "url": "https://...cloudfront.net/api/meetings/.../exports/download?format=word",
      "label": "סיכום ישיבה (Word)",
      "isPrimary": true
    },
    {
      "format": "PDF",
      "url": "https://...cloudfront.net/api/meetings/.../exports/download?format=pdf",
      "label": "סיכום ישיבה (PDF)",
      "isPrimary": false
    }
  ]
}

curl -H "userId: test@example.com" \
  "https://d1h1pi9n5z1j85.cloudfront.net/api/meetings/MEETING_ID/exports/download?format=word" \
  -o summary.docx

נתקלת בשגיאה? עברו לתקלות נפוצות ←

🔧 תקלות נפוצות ופתרונות

שגיאות 400 Bad Request

שגיאות 404 Not Found

שגיאות 500 Internal Server Error

בעיות עיבוד AI (Bedrock / Claude / Gemini)

בעיות CORS והורדת קבצים

✅ רשימת בדיקה — האם הכל עבד?

סמן כל פריט לאחר שאימתת אותו. הסימון נשמר אוטומטית בדפדפן.

• השרת מגיב עם 200 OK ב-GET /health
• יצרתי ועדה ב-POST /meetings וקיבלתי meetingId
• קריאת /upload/start החזירה uploadId ו-status: initialized
• קריאת /upload/part החזירה receivedPart: 1
• קריאת /upload/complete החזירה status: processing ו-processId
• תהליך ה-AI הגיע ל-percentage: 100 או ה-endpoint החזיר 404
• בדיקת GET /meetings/{id} — status הוא READY_FOR_EDIT
• aiContent.htmlContent — לא ריק (מכיל HTML של הסיכום)
• קריאת GET /exports — החזירה URLs לקבצי Word ו-PDF
• הורדת קובץ Word הצליחה (ישירות מהדפדפן / curl)
• קובץ ה-Word נפתח ומכיל תוכן סיכום (לא ריק)
• מחקתי את ועדת האימון מהדשבורד אם אין בה צורך