הוצאה משימוש של מותג להודעות

בחרו את תהליך ההוצאה משימוש

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

לקריאת DELETE הציבורית למחיקת מותג ולפעולת מחיקת המותג בפורטל יש היקפי פעולה שונים. הקריאה הציבורית מוחקת מותג אחד במרשם. הפורטל מתאם את ניתוק שיוכי המספרים ואת השבתת הקמפיינים לפני שהוא מנסה למחוק את המותג.

בדקו את ההשפעה בפורטל

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

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

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

היערכו למחיקה ישירה דרך API

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

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

מחקו את המותג שנבדק

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

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

תוצאת ההצלחה המתועדת היא HTTP 204 ללא גוף תשובה. אין לדרוש אובייקט הצלחה בפורמט JSON או מעטפת status/response מהגרסה הישנה v3. תוצאה שנדחתה ואינה בטווח 2xx אינה מסמנת את המותג כמחוק דרך מסלול הסנכרון הנוכחי של API.

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

אמתו את ההוצאה משימוש והסדירו תוצאות חלקיות

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

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

בתשובת HTTP 400, קראו את שגיאת המרשם המפורטת, במיוחד אם היא מציינת מגבלה עקב קמפיין פעיל. בתשובות 401, 403 או 404, בדקו את פרטי ההזדהות, את כתובת המקור המותרת בפרוטוקול האינטרנט ואת הבעלות של החשבון. בתשובת 429, פעלו לפי Retry-After. חריגה מזמן ההמתנה, 500 או 502 עלולות להתרחש לאחר ששינוי חיצוני כבר הושלם; בדקו את הרישום הקיים לפני שליחה חוזרת של הבקשה.

בדקו את החיובים שנותרו בחשבון

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