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 key שלך (נדרש היקף 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
