הסרת פרופיל רישום

הסרת פרופיל רישום מתוך החלטה מודעת

פעולה זו מהמערכת הישנה מנסה למחוק אצל ספק התקשורת את הזהות והכתובת השייכות לחשבון, ולאחר מכן מסמנת את הפרופיל המקומי כמחוק. זהו את ה־UUID של הפרופיל המקומי הנכון באמצעות documents ובדקו אותו בפורטל לפני הקריאה לפעולה. אין זו הסרה של אסמכתה בלבד או פעולה לביטול פעולה קודמת.

בקשה הרסנית מהמערכת הישנה

הזדהו באמצעות חשבון ה־API הפעיל שלכם ב־MultiTEL, מכתובת IP מורשית. הדוגמאות משתמשות בפרטי הזדהות במשתני סביבה ובנתונים בדויים. קראו את השדות status.code ו־status.msg ב־JSON, וכן את תגובת ה־HTTP.

הפורטל הנוכחי מפעיל פעולה זו באמצעות GET. למרות שיטת ה־HTTP, הפעולה משנה נתונים. לעולם אל תשתמשו בכתובת ה־URL בקישור, בתמונה, בבדיקת תקינות, בטעינה מוקדמת של הדפדפן, בסורק או בניסיון חוזר אוטומטי. באינטגרציה שלכם, התנו את המחיקה בהחלטה מפורשת של המשתמש למחוק.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID הוא מזהה הפרופיל המקומי המוחזר בשדה uuid בעת היצירה או בשדה id בעת אחזור פרטי הפרופיל. הוא אינו מזהה הזהות, מזהה הכתובת או מספר טלפון. לא נעשה שימוש בגוף בקשה.

התוצאה המדווחת

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": []
}

קוד API 404 עם ההודעה Failed, Not found פירושו שלא נמצא פרופיל בעל ה־UUID הזה עבור חשבון זה. קוד 200 מדווח פירושו שרכיב הטיפול בבקשה הגיע לתגובת הסיום שלו; אין בכך הוכחה שספק התקשורת מחק את הזהות/הכתובת או שעדכון מסד הנתונים המקומי הצליח.

אימות ההסרה והיקפה

רכיב הטיפול הנוכחי בבקשה אינו בודק את תוצאות המחיקה אצל ספק התקשורת או את תוצאות העדכון המקומי. לאחר דיווח על הצלחה, ודאו שהפרופיל אינו מופיע בתוצאות הפעילות של documents ושמתקבלת עבורו תשובת 'לא נמצא' מ־get_document. בדיקות אלו מאמתות רק את מצב הנראות המקומית. הן אינן מוכיחות שהמחיקה בוצעה אצל ספק תקשורת במעלה שרשרת השירות.

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