Verificați rezultatele evaluării unei mărci

Selectați marca pe care o verificați

Folosiți identificatorul mărcii din contul dvs. Păstrați-l împreună cu înregistrările evaluării obținute, astfel încât evaluarea unei companii să nu fie confundată cu evaluarea altei companii. Nu folosiți identificatorii altui cont.

Urmăriți o evaluare existentă

Păstrați vettingId, evpId, vettingClass și vettingStatus atunci când sunt prezente. Sincronizarea actuală tratează PENDING și UNSCORE ca rezultate care încă așteaptă verificări suplimentare, iar ACTIVE și FAILED ca rezultate finale pentru decontare. Citiți detaliile returnate înainte de a decide dacă sunt necesare acțiuni ulterioare. O listă goală nu dovedește, în sine, că o solicitare trimisă anterior nu a ajuns la registru.

Înțelegeți taxele pentru o comandă anterioară

Verificarea stării nu comandă o altă evaluare. Totuși, aceasta poate reconcilia un rezultat finalizat și poate deconta taxa aferentă unei solicitări anterioare de evaluare facturabile. Aceasta include o taxă aplicabilă în caz de eșec. Folosiți prețul și condițiile consultate la plasarea comenzii; nu deduceți prețul actual dintr-un exemplu vechi sau dintr-un răspuns privind starea.

Reîncercați citirea fără a trimite o altă comandă

În cazul unei erori temporare, păstrați identificatorul mărcii și identificatorii cunoscuți ai evaluării, respectați Retry-After și reîncercați această citire cu intervale de așteptare progresiv mai mari. Nu trimiteți o nouă comandă de evaluare doar pentru că verificarea stării a eșuat sau a returnat un corp de răspuns neașteptat. Dacă neconcordanța persistă, contactați MultiTEL printr-un canal de asistență cu autentificare, indicând identificatorii de referință relevanți.

Păstrați etapele de înregistrare separate

Evaluarea stabilește un rezultat pentru marcă. Calificarea campaniei, înregistrarea campaniei și atribuirea numerelor rămân etape separate. Verificați starea și cerințele lor actuale înainte de a trimite mesaje.

Cerere

Folosiți un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Folosiți datele de autentificare ale contului dvs., nu pe cele ale registrului. Marca trebuie să fie asociată contului autentificat.

GET cu identificatorul mărcii în cale și cu filtrul de interogare obligatoriu vettingStatus. Schema analizată definește un tablou de stări; acest exemplu solicită o singură valoare ACTIVE. Acest ghid nu stabilește codificarea mai multor valori și nici acceptarea de către furnizor a cererilor fără filtru. Nu este necesar un corp al cererii.

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

Răspuns

Ruta actuală păstrează codul de stare HTTP și corpul răspunsului registrului, în loc să folosească structura de încadrare a răspunsului din vechea versiune v3. Tabloul fictiv abreviat ilustrează câmpurile utilizate de fluxul local de sincronizare; nu este un răspuns capturat de la registru și nici o schemă garantat completă. Verificați codul de stare HTTP și conținutul JSON înainte de a citi înregistrările. Păstrați fiecare vettingId împreună cu marca selectată.

Structură ilustrativă a răspunsului; nu reprezintă date reale din cont sau o ofertă de preț actuală.

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

Erori

• 401: Autentificarea contului a eșuat. Verificați datele de autentificare, dacă accesul API este activat și restricțiile aplicabile adresei IP sursă.
• 404: Marca nu este asociată acestui cont sau registrul nu a putut să o găsească. Refuzul bazat pe verificarea apartenenței la cont are loc înainte de trimiterea cererii către registru.
• 429: A fost atinsă limita de cereri a contului sau a registrului. Respectați Retry-After și folosiți intervale de așteptare progresiv mai mari între reîncercări.
• 502/503: Transportul, registrul, mecanismul de limitare a cererilor sau procesarea locală nu este disponibilă. O eroare nu dovedește că o solicitare anterioară de evaluare a eșuat.

Disponibilitate și efecte secundare

• Această cerere GET nu plasează o nouă comandă de evaluare. Preia rezultatele din registru, scrie înregistrări de audit pentru cerere și sincronizează rezultatele stocate.
• Citirea unui rezultat finalizat poate deconta taxa pentru o comandă de evaluare facturabilă plasată anterior. O evaluare eșuată poate implica o taxă aplicabilă în caz de eșec. Consultați prețul și condițiile la plasarea comenzii; această citire nu reprezintă o ofertă de preț.
• O înregistrare nou descoperită, importată prin această cerere GET, nu este clasificată automat drept o nouă comandă facturabilă.
• Un rezultat al evaluării reușit sau ACTIVE nu reprezintă aprobarea campaniei, atribuirea unui număr de telefon sau permisiunea de a trimite mesaje.