Απόσυρση επωνυμίας για την αποστολή μηνυμάτων

Επιλέξτε τη διαδικασία απόσυρσης

Αποσύρετε μια επωνυμία για την αποστολή μηνυμάτων όταν η επιχείρηση δεν χρειάζεται πλέον τη συγκεκριμένη καταχώριση. Με αυτή την ενέργεια παύει η χρήση της υπάρχουσας καταχώρισης· δεν καταχωρίζεται αντικατάσταση, δεν αποδεσμεύονται μισθωμένοι αριθμοί τηλεφώνου και δεν διορθώνονται τα στοιχεία ταυτότητας της επιχείρησης. Για διόρθωση, χρησιμοποιήστε την επιλογή Ενημέρωση επωνυμίας για την αποστολή μηνυμάτων.

Η δημόσια κλήση DELETE για την επωνυμία και η ενέργεια Διαγραφή επωνυμίας της πύλης έχουν διαφορετικό εύρος λειτουργίας. Η δημόσια κλήση διαγράφει μία επωνυμία από το μητρώο. Η πύλη συντονίζει την αποσύνδεση των αριθμών και την απενεργοποίηση των καμπανιών πριν επιχειρήσει τη διαγραφή της επωνυμίας.

Εξετάστε τις επιπτώσεις στην πύλη

Ανοίξτε τη σελίδα καταχώρισης για την αποστολή μηνυμάτων, βρείτε τη σωστή επωνυμία και επιλέξτε Διαγραφή επωνυμίας. Ελέγξτε το πλήθος των συσχετισμένων καμπανιών και των αντιστοιχισμένων αριθμών. Πληκτρολογήστε το ακριβές αναγνωριστικό της επωνυμίας για να ενεργοποιηθεί η τελική ενέργεια. Η φόρμα πελάτη είναι διαθέσιμη μόνο όταν ο λογαριασμός διαθέτει δικαίωμα διαχείρισης καταχωρίσεων.

Η πύλη επεξεργάζεται τις ενεργές καμπάνιες διαδοχικά: επιχειρεί να αποσυνδέσει κάθε αριθμό που είναι αντιστοιχισμένος εκείνη τη στιγμή, απενεργοποιεί την καμπάνια και, στη συνέχεια, διαγράφει την επωνυμία. Παραλείπει την επανάληψη της απομακρυσμένης διαγραφής για καμπάνιες που έχουν ήδη επισημανθεί ως ληγμένες ή διαγραμμένες. Αφού ολοκληρωθούν επιτυχώς αυτά τα εξωτερικά βήματα, ενημερώνει τις τοπικές εγγραφές καμπανιών και αριθμών μέσα σε μια συναλλαγή βάσης δεδομένων.

Αυτή η ακολουθία δεν αποτελεί μία ενιαία ατομική συναλλαγή μεταξύ του μητρώου, του τηλεπικοινωνιακού παρόχου και των τοπικών εγγραφών. Μια μεταγενέστερη αποτυχία δεν μπορεί να επαναφέρει έναν αριθμό ή μια καμπάνια που έχει ήδη αλλάξει σε εξωτερικό σύστημα. Διατηρήστε τα στοιχεία που επιστρέφονται για τους αποσυνδεδεμένους αριθμούς και τις απενεργοποιημένες καμπάνιες, όταν είναι διαθέσιμα· ελέγξτε και ευθυγραμμίστε τις καταστάσεις που αντιστοιχούν σε αυτά τα αναγνωριστικά αντί να δημιουργήσετε άλλη επωνυμία.

Προετοιμάστε μια απευθείας διαγραφή μέσω API

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API μέσω HTTPS από επιτρεπόμενη διεύθυνση IP προέλευσης. Η επωνυμία πρέπει να ανήκει σε αυτόν τον λογαριασμό. Διαβάστε και διατηρήστε το αναγνωριστικό και την τρέχουσα κατάστασή της και, στη συνέχεια, ελέγξτε τις καμπάνιες και τις αντιστοιχίσεις αριθμών της. Αποσυνδέστε τους επηρεαζόμενους αριθμούς και απενεργοποιήστε τις καμπάνιες πριν διαγράψετε την επωνυμία. Μην θεωρείτε αυτή την κλήση 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 ούτε το παλαιό περίβλημα v3 status/response. Ένα απορριφθέν αποτέλεσμα με κωδικό εκτός 2xx δεν επισημαίνει την επωνυμία ως διαγραμμένη μέσω της τρέχουσας διαδικασίας συγχρονισμού του API.

Χρησιμοποιήστε ένα κλειδί ιδιοδυναμίας για το προβλεπόμενο αίτημα. Κατά την επανάληψη, διατηρήστε αμετάβλητα τη μέθοδο, τη διαδρομή, τη συμβολοσειρά ερωτήματος και τα byte του σώματος. Το κλειδί δεν καθιστά ατομική την ευρύτερη εκκαθάριση της πύλης και δεν αποδεικνύει ότι αποσυνδέθηκε κάποιος αριθμός στον τηλεπικοινωνιακό πάροχο. Ένα διπλότυπο αίτημα, ενώ το αρχικό βρίσκεται ακόμη σε εξέλιξη, μπορεί να επιστρέψει 409 με Retry-After· τα ολοκληρωμένα αιτήματα μπορούν να επιστρέψουν ξανά την αποθηκευμένη απόκρισή τους, ακόμη και αν πρόκειται για σφάλμα.

Επαληθεύστε την απόσυρση και συμφωνήστε τα μερικά αποτελέσματα

Μετά τη λειτουργία, ελέγξτε τις λίστες επωνυμιών και καμπανιών της πύλης, καθώς και τους επηρεαζόμενους αριθμούς. Ο συγχρονισμός του δημόσιου API σε περίπτωση επιτυχίας επισημαίνει τη συγκεκριμένη επωνυμία ως διαγραμμένη τοπικά· δεν αφαιρεί τους άλλους πόρους καμπανιών ούτε εκκαθαρίζει τις αντιστοιχίσεις αγορασμένων αριθμών. Η κατάσταση στο μητρώο, η αντιστοίχιση στον τηλεπικοινωνιακό πάροχο και η τοπική εμφάνιση απαιτούν ξεχωριστούς ελέγχους.

Ο τρέχων προσαρμογέας της πύλης για τον τηλεπικοινωνιακό πάροχο αποδέχεται μια επιτυχή απόκριση HTTP χωρίς να επικυρώνει ξεχωριστά κάθε τιμή κατάστασης επιχειρησιακής λειτουργίας στο σώμα της. Για τον λόγο αυτό, μετά από εκκαθάριση μέσω της πύλης, επαληθεύστε τις πραγματικές αντιστοιχίσεις των επηρεαζόμενων αριθμών σε καμπάνιες, ακόμη και αν η πύλη ανέφερε επιτυχία. Αν κάποια αντιστοίχιση ή κατάσταση παρουσιάζει ασυνέπεια, διατηρήστε τα σχετικά αναγνωριστικά και επικοινωνήστε με την υποστήριξη πριν στείλετε μηνύματα μέσω της αποσυρμένης διαμόρφωσης ή τη δημιουργήσετε ξανά.

Για HTTP 400, διαβάστε το αναλυτικό σφάλμα του μητρώου, ιδιαίτερα τυχόν περιορισμό λόγω ενεργής καμπάνιας. Για 401, 403 ή 404, ελέγξτε τα διαπιστευτήρια, την επιτρεπόμενη διεύθυνση IP προέλευσης και αν η επωνυμία ανήκει στον λογαριασμό. Για 429, τηρήστε το Retry-After. Ένα χρονικό όριο που εξαντλείται ή ένα σφάλμα 500 ή 502 μπορεί να προκύψει μετά από εξωτερική αλλαγή που έχει ήδη ολοκληρωθεί· εξετάστε την υπάρχουσα καταχώριση πριν επαναλάβετε το αίτημα.

Ελέγξτε τις υπόλοιπες χρεώσεις του λογαριασμού

Η τρέχουσα υπηρεσία DELETE δεν δρομολογεί άμεση χρέωση για την καταχώριση επωνυμίας. Η διαγραφή μιας επωνυμίας δεν αποδεσμεύει τους μισθωμένους αριθμούς τηλεφώνου, δεν εκδίδει επιστροφή χρημάτων και δεν καθορίζει το τελικό υπόλοιπο του λογαριασμού. Ελέγξτε στην πύλη τυχόν υφιστάμενες δεσμεύσεις για καμπάνιες, τη μίσθωση αριθμών και τις χρεώσεις χρήσης. Αυτή η λειτουργία δεν αποτελεί προσφορά τιμής για τις συγκεκριμένες ξεχωριστές υπηρεσίες.