Partner API – חיפוש משתמש לפי אימייל
נקודת קצה חדשה ב-Partner API מאפשרת לשותפים לחפש כל חשבון משתמש לפי כתובת אימייל – ומחזירה את חברות המשתמש בסביבות עבודה, מזהי סביבות העבודה והתפקידים בכל סביבות העבודה שאליהן משתייך המשתמש.
נקודת קצה חדשה
שיטהנקודת קצהתיאורGET | /partner/find-user-by-email | חיפוש משתמש לפי כתובת אימייל
פרמטרים
שםסוגנדרשתיאורemail | string (query) | ✅ כן | כתובת האימייל לחיפוש
limit | integer ($int64, query) | לא | מספר הפריטים בתגובה
page | integer ($int64, query) | לא | מספר עמוד, בין 1 ל-100
limit | integer ($int64, query) | לא | מספר הפריטים בתגובה
page | integer ($int64, query) | לא | מספר עמוד, בין 1 ל-100
דוגמת תגובה
{
"data": [
{
"user_id": 0,
"workspace_id": 0,
"workspace_name": "string",
"role": "string"
}
]
}
שגיאה (400):
{ "message": "Error message" }
מה חדש
- 🔍 חיפוש כל משתמש לפי אימייל דרך Partner API – ניתן לאתר פרטי חשבון וחברות בסביבות עבודה בקריאה אחת
- 📋 מחזיר user_id, workspace_id, workspace_name ו-role עבור כל סביבת עבודה שאליה משתייך המשתמש
- 📄 תומך בעימוד באמצעות הפרמטרים limit ו-page (עד עמוד 100)
- 🔑 דורש הרשאת Manage Team (ניהול צוות) בטוקן Partner API שלך
אופן השימוש
- אימות באמצעות מפתח Partner API שלך (נדרשת הרשאת Manage Team)
- קריאה ל-GET /partner/find-user-by-email?email=user@example.com
- ניתן להוסיף &limit=20&page=1 לתוצאות מעומדות
- ניתוח מערך ה-data כדי לראות לאילו סביבות עבודה המשתמש משתייך ומה התפקיד שלו בכל אחת
תיעוד API מלא: partner-api#/Partner Management/partnerFindUserByEmail
למה זה חשוב
- מאפשר לשותפים לבצע ביקורת גישה של משתמשים לסביבות עבודה בכל חשבונות הלקוחות באופן תכנותי
- שימושי לתהליכי תמיכה – איתור מהיר של סביבות העבודה שאליהן משתייך משתמש לפי אימייל ללא חיפוש ידני בממשק
- תומך באוטומציה של ניהול חשבונות, כגון הסרת משתמשים בין סביבות עבודה או ביקורת תפקידים
👉 תכונה לשותפים בלבד. דורשת הרשאת Manage Team. פורסם: 12 בפברואר 2026
