Folosiți o marcă de mesagerie care aparține contului
Folosiți un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Sunt acceptate autentificările Basic și Bearer. Identificatorul mărcii trebuie să aparțină acelui cont. Păstrați confidențiale tokenurile furnizorilor, datele de identitate ale mărcii și rapoartele primite.
Comandați o nouă verificare externă
Folosiți POST când aveți nevoie ca un furnizor de verificări să efectueze o nouă verificare pentru această marcă. Dacă aveți deja un rezultat de la un furnizor, folosiți importul în schimb. Această operațiune este separată de reverificarea identității mărcii.
Mai întâi, consultați datele actuale ale mărcii și confirmați informațiile de identitate. Selectați un furnizor și o clasă acceptate din cataloagele actuale și verificați cerințele furnizorului respectiv. Nu fiecare furnizor acceptă toate clasele. Detaliile suplimentare pentru verificarea politică trebuie să descrie organizația sau campania reală, nu să conțină date demonstrative.
Pregătiți cererea către furnizor
| Câmp | Valoare |
|---|---|
| evpId | Identificator obligatoriu al furnizorului din catalogul actual al furnizorilor de verificări externe, cu 1–10 caractere. |
| vettingClass | Clasa acceptată pe care intenționați să o cumpărați; selectați-o explicit și confirmați-i prețul. |
| additionalRequestPayload | Un șir de caractere codificat în JSON, cu detalii specifice furnizorului, obligatoriu pentru verificarea politică. Este un șir de caractere în interiorul obiectului JSON exterior, nu un obiect imbricat. Confirmați toate detaliile obligatorii cu furnizorul selectat. |
Confirmați tarifele pentru reușită și eșec
Tarifele actuale pentru clienții finali, în dolari SUA, consultate la 24 octombrie 2026. Confirmați suma actuală înainte de a plasa o comandă reală. Se verifică dacă soldul preplătit acoperă prețul pentru reușită; achizițiile trebuie să fie activate.
| Clasă | Rezultat activ | Rezultat de eșec |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL cu cerere Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Comenzile în așteptare își păstrează sumele pentru reușită/eșec și sunt decontate când se sincronizează un rezultat ACTIVE sau FAILED. Ultimele două clase folosesc același tarif configurat pentru oricare dintre rezultatele finale. Un rezultat final imediat poate fi taxat în timpul răspunsului la comandă. Sincronizarea ulterioară a stării poate deconta o taxă în așteptare.
Nu considerați că mock:true garantează o verificare externă gratuită. Fluxul actual de decontare a verificării externe poate totuși să înregistreze și să taxeze acea comandă. Aceste instrucțiuni nu impun o achiziție reală pentru testare; folosiți seturi de date de test offline până când intenționați să autorizați o verificare contra cost.
Trimiteți o singură comandă verificată
Pregătiți vetting-order.json cu identificatorul furnizorului, clasa și toate informațiile suplimentare obligatorii. Fișierul conține cererea efectivă pe care intenționați să o trimiteți. Păstrați-l confidențial.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Urmăriți rezultatul efectiv
Un răspuns HTTP reușit poate conține o înregistrare de verificare în așteptare. Păstrați valoarea vettingId a acesteia și examinați vettingStatus, motivele, scorul și datele de intrare în vigoare/expirare, dacă sunt disponibile. PENDING și UNSCORE necesită urmărire suplimentară; ACTIVE, FAILED și EXPIRED descriu rezultate diferite. Simpla acceptare HTTP nu dovedește un scor favorabil sau eligibilitatea campaniei.
Folosiți starea verificării externe pentru a urmări înregistrarea. Citirea sau importarea unui rezultat final poate deconta o comandă anterioară contra cost; operațiunea nu este neapărat scutită de o taxă existentă încă neachitată.
Reîncercați aceeași cerere intenționată
Folosiți o singură Idempotency-Key pentru fiecare operațiune intenționată și păstrați exact metoda, calea, parametrii de interogare și octeții corpului cererii. Cheile acceptă 1–128 de caractere ASCII imprimabile, fără spații. Un duplicat al unei cereri în curs poate returna 409 cu Retry-After. Cererile finalizate returnează din nou răspunsul stocat, inclusiv erorile. Respectați limitele de frecvență ale cererilor.
Un răspuns 502 stocat în cache poate apărea în urma unei erori de transport. Un răspuns 500 stocat în cache, cu requestId, poate însemna că registrul a acceptat operațiunea, dar salvarea locală sau facturarea a eșuat. Păstrați identificatorul cererii, examinați înregistrările actuale și clarificați situația cu echipa de asistență înainte de a folosi o cheie nouă. Nu presupuneți că eroarea înseamnă că nu există nicio comandă.