הסרת הפניה להעלאה שאינה בשימוש

בחרו הפניה להעלאה שאינה בשימוש

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

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

בקשו הסרה בפעולה מכוונת

השתמשו בחשבון API פעיל של MultiTEL דרך HTTPS, עם פרטי ההזדהות וההגבלות על כתובות IP שהוגדרו עבורו. השתמשו ב־POST כדי שהיישום שלכם יתייחס לכך כשינוי מכוון:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

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

הבינו את התוצאה ואת מגבלותיה

קראו גם את תוצאת HTTP וגם את השדה status.code ב־JSON. תגובת ההצלחה הרגילה היא:

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

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

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

הסרה אינה מחיקה מלאה של הנתונים

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

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