Επαναληπτική επαλήθευση επωνυμίας αποστολής μηνυμάτων

Επανέλεγχος της διορθωμένης ταυτότητας της επιχείρησης

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

Χρησιμοποιήστε τον δικό σας ενεργοποιημένο λογαριασμό API μέσω HTTPS, από επιτρεπόμενη διεύθυνση IP προέλευσης. Η επωνυμία πρέπει να ανήκει σε αυτόν τον λογαριασμό. Διατηρείτε ιδιωτικές τις εγγραφές επωνυμιών: περιέχουν επιχειρηματικά στοιχεία και στοιχεία επικοινωνίας.

Έλεγχος της επωνυμίας πριν από την υποβολή

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

Ελέγξτε ότι η επωνυμία που επιστρέφεται αντιστοιχεί στην επιθυμητή επιχείρηση και ότι περιλαμβάνεται η διόρθωση. Όσο η αρχική καταχώριση εκκρεμεί, δεν μπορεί ακόμη να πραγματοποιηθεί επαναληπτική επαλήθευση. Το μητρώο μπορεί να απορρίψει ένα αίτημα όταν τα επιχειρηματικά στοιχεία παραμένουν αμετάβλητα. Αν λείπουν ειδικά χαρακτηριστικά, ενδέχεται να απαιτείται ένσταση αντί για νέο έλεγχο ταυτότητας. Οι επωνυμίες ατομικών επιχειρήσεων χρησιμοποιούν την κατάλληλη διαδικασία ταυτότητας/PIN· μην θεωρείτε αυτό το τελικό σημείο υποκατάστατό της.

Επιβεβαίωση της ξεχωριστής χρέωσης

Η τρέχουσα ρυθμισμένη χρέωση επαναληπτικής επαλήθευσης στο περιβάλλον παραγωγής είναι US$5.00 ανά αποδεκτή προσπάθεια, όπως ελέγχθηκε στις 24 Οκτωβρίου 2026. Εφαρμόζεται η τυπική χρέωση επωνυμίας, ακόμη και όταν η αρχική οντότητα έχει διαφορετική τιμή καταχώρισης. Οι αγορές πρέπει να είναι ενεργοποιημένες· οι προπληρωμένοι λογαριασμοί χρειάζονται επαρκές υπόλοιπο πριν από την υποβολή.

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

Υποβολή μίας συγκεκριμένης προσπάθειας

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

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

Το δημόσιο API δέχεται επίσης έλεγχο ταυτότητας Bearer για έναν ενεργοποιημένο λογαριασμό με διακριτικό. Οι έλεγχοι κυριότητας του λογαριασμού και επιτρεπόμενης διεύθυνσης IP προέλευσης εξακολουθούν να ισχύουν. Οι αποθηκευμένες εικονικές επωνυμίες παρακάμπτουν αυτή τη διαδικασία χρέωσης παραγωγής, αλλά ένα αποτέλεσμα στο δοκιμαστικό περιβάλλον δεν αποτελεί επαλήθευση ταυτότητας στο περιβάλλον παραγωγής.

Ανάγνωση του αποτελέσματος και παρακολούθηση της κατάστασής του

Αποκρίσεις επαναληπτικής επαλήθευσης
Απόκριση	Σημασία και επόμενη ενέργεια
200	Το αίτημα ολοκληρώθηκε επιτυχώς. Εξετάστε την επωνυμία που επιστράφηκε και διαβάστε ξανά την τρέχουσα εγγραφή της για να επιβεβαιώσετε την κατάσταση της ταυτότητας.
202	Το αίτημα έγινε αποδεκτό και εκκρεμεί περαιτέρω επαλήθευση. Κρατήστε το αναγνωριστικό της επωνυμίας και ελέγξτε την τρέχουσα κατάστασή της αργότερα, χωρίς να υποβάλετε άλλη προσπάθεια επί πληρωμή.
400	Εξετάστε τα σφάλματα μητρώου που επιστράφηκαν. Η αρχική καταχώριση μπορεί να εκκρεμεί, το προφίλ μπορεί να παραμένει αμετάβλητο ή μπορεί να ισχύει άλλος κανόνας επικύρωσης.
401 / 404	Ελέγξτε τα διαπιστευτήρια και την επιτρεπόμενη διεύθυνση IP ή το αναγνωριστικό της επωνυμίας που ανήκει στον λογαριασμό.
402 / 503	Εξετάστε το τοπικό σφάλμα αγοράς ή χρηματοδότησης, ή το σφάλμα τιμολόγησης ή υπηρεσίας. Μην υποθέτετε ότι κάθε απόκριση 503 αποδεικνύει πως δεν πραγματοποιήθηκε αίτημα προς την ανάντη υπηρεσία.
429	Τηρήστε το Retry-After και διατηρήστε τα ίδια στοιχεία της προσπάθειας.

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

Διερεύνηση αβέβαιου αποτελέσματος

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

Χρήση της πύλης πελατών

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

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