Ελέγξτε τα αποτελέσματα αξιολόγησης μιας επωνυμίας

Επιλέξτε την επωνυμία που ελέγχετε

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

Παρακολουθήστε μια υπάρχουσα αξιολόγηση

Διατηρήστε τα vettingId, evpId, vettingClass και vettingStatus όταν υπάρχουν. Ο τρέχων συγχρονισμός αντιμετωπίζει τα PENDING και UNSCORE ως αποτελέσματα που εξακολουθούν να αναμένουν περαιτέρω έλεγχο, και τα ACTIVE και FAILED ως οριστικά αποτελέσματα για τον διακανονισμό των χρεώσεων. Διαβάστε τις λεπτομέρειες που επιστρέφονται πριν αποφασίσετε αν χρειάζονται περαιτέρω ενέργειες. Μια κενή λίστα από μόνη της δεν αποδεικνύει ότι μια προηγούμενη υποβολή δεν έφτασε στο μητρώο.

Κατανοήστε τις χρεώσεις μιας προηγούμενης παραγγελίας

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

Επαναλάβετε την ανάγνωση χωρίς να υποβάλετε άλλη παραγγελία

Σε περίπτωση προσωρινής αποτυχίας, διατηρήστε το αναγνωριστικό επωνυμίας και τα γνωστά αναγνωριστικά αξιολόγησης, τηρήστε το Retry-After και επαναλάβετε αυτή την ανάγνωση με σταδιακά αυξανόμενη αναμονή μεταξύ των προσπαθειών. Μην υποβάλετε νέα παραγγελία αξιολόγησης μόνο και μόνο επειδή η αναζήτηση κατάστασης απέτυχε ή επέστρεψε μη αναμενόμενο σώμα απόκρισης. Αν η ασυμφωνία επιμένει, επικοινωνήστε με τη MultiTEL μέσω καναλιού υποστήριξης με έλεγχο ταυτότητας, παρέχοντας τα σχετικά αναγνωριστικά αναφοράς.

Διατηρήστε χωριστά τα βήματα καταχώρισης

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

Αίτημα

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

Εκτελέστε αίτημα GET με το αναγνωριστικό επωνυμίας στη διαδρομή και το υποχρεωτικό φίλτρο ερωτήματος vettingStatus. Το σχήμα που εξετάστηκε ορίζει έναν πίνακα καταστάσεων· αυτό το παράδειγμα ζητά μία τιμή ACTIVE. Ο παρών οδηγός δεν τεκμηριώνει την κωδικοποίηση πολλαπλών τιμών ούτε την αποδοχή αιτημάτων χωρίς φίλτρο από τον πάροχο. Δεν απαιτείται σώμα αιτήματος.

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

Απόκριση

Η τρέχουσα διαδρομή διατηρεί την κατάσταση HTTP και το σώμα απόκρισης του μητρώου αντί να χρησιμοποιεί το παλαιό περίβλημα απόκρισης v3. Ο συντομευμένος υποθετικός πίνακας παρουσιάζει πεδία που χρησιμοποιούνται από την τοπική διαδικασία συγχρονισμού· δεν αποτελεί καταγεγραμμένη απόκριση του μητρώου ούτε σχήμα με εγγυημένη πληρότητα. Ελέγξτε την κατάσταση HTTP και το περιεχόμενο JSON πριν διαβάσετε τις εγγραφές. Διατηρήστε κάθε vettingId μαζί με την επιλεγμένη επωνυμία.

Ενδεικτική δομή απόκρισης· δεν αποτελεί πραγματικά δεδομένα λογαριασμού ούτε τρέχουσα προσφορά τιμής.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Σφάλματα

• 401: Ο έλεγχος ταυτότητας του λογαριασμού απέτυχε. Ελέγξτε τα διαπιστευτήρια, αν είναι ενεργοποιημένο το API και τους ισχύοντες περιορισμούς IP προέλευσης.
• 404: Η επωνυμία δεν συνδέεται με αυτόν τον λογαριασμό ή το μητρώο δεν μπόρεσε να τη βρει. Η απόρριψη λόγω μη υπαγωγής της επωνυμίας στον λογαριασμό γίνεται πριν από το αίτημα προς το μητρώο.
• 429: Συμπληρώθηκε το όριο αιτημάτων του λογαριασμού ή του μητρώου. Τηρήστε το Retry-After και αυξάνετε σταδιακά την αναμονή μεταξύ των προσπαθειών.
• 502/503: Η μεταφορά, το μητρώο, ο μηχανισμός περιορισμού αιτημάτων ή η τοπική επεξεργασία δεν είναι διαθέσιμα. Ένα σφάλμα δεν αποδεικνύει ότι ένα προηγούμενο αίτημα αξιολόγησης απέτυχε.

Διαθεσιμότητα και παράπλευρες επιπτώσεις

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