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

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

Ενημερώστε το υπάρχον εμπορικό σήμα όταν αλλάζουν τα στοιχεία επικοινωνίας της επιχείρησης ή μια διεύθυνση. Διατηρήστε το αναγνωριστικό του εμπορικού σήματος· η δημιουργία άλλης εγγραφής δεν είναι ο τρόπος διόρθωσης μιας υπάρχουσας επιχείρησης. Χρησιμοποιήστε ενεργοποιημένο λογαριασμό 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

Διατήρηση των τρεχόντων πεδίων του εμπορικού σήματος

Προετοιμάστε το brand-update.json από την τρέχουσα εγγραφή, επιλέγοντας μόνο τα εγγράψιμα πεδία του εμπορικού σήματος. Διατηρήστε τα στοιχεία ταυτότητας της επιχείρησης και τις υπόλοιπες απαιτούμενες τιμές κατά την εφαρμογή της επιθυμητής διόρθωσης. Μην αποστείλετε ολόκληρη την απόκριση GET: το brandId, τα αποτελέσματα ταυτότητας και κατάστασης, οι χρονικές σημάνσεις και τα άλλα πεδία που υπάρχουν μόνο στην απόκριση δεν πρέπει να περιλαμβάνονται στην ενημέρωση.

Το σχήμα ενημέρωσης απαιτεί τα entityType, displayName, country, email και brandRelationship. Εξακολουθούν να ισχύουν οι κανόνες που αφορούν τον τύπο της οντότητας. Για έναν οργανισμό, διατηρήστε τη νόμιμη εταιρική επωνυμία, το φορολογικό αναγνωριστικό και τη χώρα έκδοσής του, τη διεύθυνση και τον κλάδο δραστηριότητας, κατά περίπτωση. Για ατομική επιχείρηση, διατηρήστε αντί αυτών τα σχετικά πεδία προσωπικού ονόματος και επικοινωνίας μέσω κινητού. Χρησιμοποιήστε πραγματικές τρέχουσες τιμές, όχι τις ενδεικτικές τιμές από ένα παράδειγμα εγγραφής.

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

Υποβολή της ελεγμένης διόρθωσης

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand-update.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

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

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

Μια επιτυχής ενημέρωση επιστρέφει HTTP 200 και απευθείας ένα αντικείμενο JSON του εμπορικού σήματος, χωρίς το παλαιό περίβλημα status/response της v3. Ελέγξτε το brandId του και κατόπιν ανακτήστε ξανά το ίδιο εμπορικό σήμα με GET και συγκρίνετε τα πεδία που θέλατε να αλλάξετε. Η δημόσια διαδρομή ενημέρωσης δεν δέχεται το περίβλημα changes/version της πύλης ούτε παρέχει τον αισιόδοξο έλεγχο ταυτόχρονων αλλαγών της. Συντονίστε όσους επεξεργάζονται ταυτόχρονα την εγγραφή· ένα κλειδί ιδιοδυναμίας αποτρέπει τη διπλή υποβολή, όχι τις αλλαγές άλλου χρήστη.

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

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

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

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

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