ניהול משתמשים

services לניהול משתמשי המערכת, ההרשאות שלהם, שיוך מסקיו ויומן גישה.

---

set_user

יצירת משתמש חדש. המערכת תיצור אוטומטית:

• פרופיל משתמש.
• סט הרשאות ברירת-מחדל לדוחות.
• תגית אישית בשם #<email>.

אזור הזמן, השפה ופורמט התאריך מועתקים ממשתמש המנהל הראשי של החשבון.

Endpoint: /api/?service=set_user

פרמטרים

פרמטר	סוג	חובה	תיאור
email	string	כן	עד 99 תווים.
password	string	כן	לפחות 8 תווים. חייב לעמוד במדיניות הסיסמאות של המערכת.
user_phone	string	לא	טלפון (יומר לפורמט בינלאומי).
user_phone_sms	string	לא	טלפון לקבלת SMS (יומר לפורמט בינלאומי).
user_login	string	לא	שם משתמש (אם ריק – יילקח החלק לפני ה-@ ב-email).
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
7001	email ריק או ארוך מ-99
7002	password קצר מ-8 / לא עומד במדיניות
7003	כשל ביצירת משתמש
7004	כשל ביצירת פרופיל
7005	כשל ביצירת הרשאות ברירת-מחדל

דוגמה

curl -H "Authorization: Bearer TOKEN" \
     -X POST "https://[MASKYOO_URL]/api/?service=set_user" \
     -d "[email protected]" \
     -d "password=Str0ng!Pass" \
     -d "user_phone=972544224422" \
     -d "user_login=john" \
     -d "format=json"

---

update_user

עדכון משתמש קיים. תומך בעדכון סיסמה (ערך ריק = לא לעדכן), טלפון, טלפון SMS וסטטוס.

Endpoint: /api/?service=update_user

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	מזהה המשתמש.
password	string	לא	סיסמה חדשה (אם נשלחת, חייבת לעמוד במדיניות).
user_phone	string	לא	טלפון חדש (לפחות 6 תווים).
user_phone_sms	string	לא	טלפון SMS חדש.
user_status	int	לא	0 / 1.
user_login	string	לא	שם משתמש חדש.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
7011	user_id חסר
7012	כשל בעדכון
7013	הסיסמה לא עומדת במדיניות

---

delete_user

מחיקת משתמש, כולל הרשאות, פרופילים ושיוך מסקיו.

Endpoint: /api/?service=delete_user

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	המשתמש למחיקה.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
7021	user_id חסר
7022	המשתמש לא קיים
7023	כשל במחיקת המשתמש
7024	כשל בהסרת השיוך למספרי מסקיו
7025	כשל במחיקת פרופיל המשתמש
7026	כשל במחיקת הרשאות המשתמש

caution

המחיקה אינה הפיכה. בדקו טרם שימוש.

---

get_user_by_id

פרטי משתמש בודד (ללא סיסמה), כולל הרשאות ומסקיו משויכים.

Endpoint: /api/?service=get_user_by_id

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	מזהה המשתמש.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
7031	user_id חסר
7032	המשתמש לא קיים

---

get_users

רשימת כל המשתמשים (ללא סיסמאות), כל אחד עם ההרשאות והמסקיו המשויכים לו.

Endpoint: /api/?service=get_users

פרמטרים

פרמטר	סוג	חובה	תיאור
format	string	לא	json / xml.

קוד שגיאה

קוד	תיאור
7041	אין תוצאות

---

set_ddi_to_user

שיוך מספר מסקיו למשתמש (הרשאת צפייה/ניהול).

Endpoint: /api/?service=set_ddi_to_user

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	המשתמש.
maskyoo	string	כן	מספר המסקיו.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
8001	user_id חסר
8002	maskyoo חסר
8003	המשתמש לא קיים
8004	המסקיו לא קיים
8005	כשל בשיוך
8006	השיוך כבר קיים

---

get_ddi_by_user_id

רשימת מספרי המסקיו המשויכים למשתמש (כולל סטטוס: active / inactive / release).

Endpoint: /api/?service=get_ddi_by_user_id

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	מזהה המשתמש.
format	string	לא	json / xml.

קוד שגיאה

קוד	תיאור
8011	user_id חסר
8012	אין תוצאות למשתמש

---

delete_ddi_from_user_id

ביטול שיוך של מספר מסקיו למשתמש.

Endpoint: /api/?service=delete_ddi_from_user_id

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	כן	המשתמש.
maskyoo	string	כן	המספר להסרה.
format	string	לא	json / xml.

קודי שגיאה

קוד	תיאור
8021	user_id חסר
8022	maskyoo חסר
8023	המשתמש לא קיים
8024	המסקיו לא קיים
8025	השיוך לא קיים
8026	כשל בהסרה

---

get_users_access_log

יומן כניסות משתמשים (עד 1000 שורות, בסדר יורד). ניתן לסנן לפי משתמש ולפי טווח זמנים.

Endpoint: /api/?service=get_users_access_log

פרמטרים

פרמטר	סוג	חובה	תיאור
user_id	int	לא	סינון לפי משתמש.
start_time	string	לא	Y-m-d H:i:s. אם רק start_time נשלח – end_time = עכשיו.
end_time	string	לא	Y-m-d H:i:s.
format	string	לא	json / xml.

שדות בתגובה

access_log_user_id, access_log_name, access_log_time, access_log_status, access_log_ip.

קוד שגיאה

קוד	תיאור
6001	אין תוצאות

השפעות על המערכת

services של ניהול משתמשים משפיעים על גישה, הרשאות ודוחות:

• יצירת משתמש — set_user זהה ליצירה בממשק: יוצר פרופיל, הרשאות ברירת‑מחדל ותגית אישית #<email>
• שיוך DDI — set_ddi_to_user קובע אילו מספרי מסקיו המשתמש רואה בדוחות ובמסכי הניהול
• מחיקת משתמש — פעולה בלתי הפיכה; מסירה הרשאות, פרופיל ושיוך מסקיו, ופוסלת את כל הטוקנים הקשורים למשתמש
• סיסמאות — חייבות לעמוד במדיניות הסיסמאות של המערכת; אי‑עמידה מחזירה 7002/7013
• יומן גישה — get_users_access_log משקף את אותן רשומות שנראות בדוח הגישה; מוגבל ל‑1000 שורות
• אזור זמן ושפה — פרטים אלה מועתקים מהמנהל הראשי בעת יצירת משתמש ב‑API

ראו גם

• ניהול משתמשים
• יצירת משתמש חדש
• יומן כניסות למערכת
• ניהול תגיות
• ניהול מסקיו