Utilizați o marcă de mesagerie care aparține contului
Utilizați un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Sunt acceptate metodele de autentificare Basic și Bearer. Identificatorul mărcii trebuie să aparțină acelui cont. Păstrați confidențialitatea tokenurilor furnizorului, a datelor de identitate ale mărcii și a rapoartelor returnate.
Utilizați un rezultat existent de la furnizor
Utilizați PUT pentru a asocia mărcii dumneavoastră un rezultat de verificare existent de la un furnizor acceptat. Această operațiune nu comandă o verificare nouă. Obțineți identificatorul corect al tranzacției furnizorului și orice token de confirmare direct de la furnizorul respectiv și asigurați-vă că raportul corespunde aceleiași identități a întreprinderii.
AUTHPLUS nu acceptă acest flux de import. Regulile de corelare specifice furnizorului se aplică în continuare; o cerere de import nu înlătură aceste reguli și nu garantează eligibilitatea pentru fiecare caz de utilizare a campaniilor.
Pregătiți importul
| Câmp | Valoare |
|---|---|
| evpId | Identificatorul furnizorului acceptat, 1–10 caractere. |
| vettingId | Identificatorul real al tranzacției de verificare a furnizorului, de cel mult 255 de caractere. Nu îl înlocuiți cu identificatorul mărcii și nu inventați un identificator. |
| vettingToken | Tokenul de confirmare, atunci când este cerut de furnizor, de cel mult 65535 de caractere. Tratați-l ca pe un secret și omiteți-l atunci când furnizorul nu îl solicită. |
Creați vetting-import.json folosind valorile reale de la furnizor. Nu trimiteți câmpurile de punctaj, stare sau marcaj temporal care apar doar în răspuns ca și cum acestea ar putea modifica rezultatul.
Importați rezultatul o singură dată
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 @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Înțelegeți taxele existente
Acest proxy nu înregistrează un rezultat nou importat ca pe o comandă nouă cu plată. Acest lucru nu anulează o verificare comandată anterior: dacă pentru același vettingId există deja o comandă care așteaptă rezultatul sau perceperea taxei, importarea unui rezultat ACTIVE sau FAILED poate duce la încasarea taxei memorate pentru acea comandă. Această ramură de sincronizare nu percepe din nou taxa pentru o înregistrare deja taxată.
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, punctajul și datele de intrare în vigoare și de expirare, în măsura în care sunt disponibile. PENDING și UNSCORE necesită urmărire în continuare; ACTIVE, FAILED și EXPIRED descriu rezultate diferite. Simpla acceptare HTTP nu dovedește un punctaj favorabil sau eligibilitatea pentru campanii.
Utilizați starea verificării externe pentru a urmări înregistrarea. Citirea sau importarea unui rezultat final poate duce la încasarea taxei pentru o comandă cu plată anterioară; operațiunea nu este neapărat scutită de o taxă existentă neachitată.
Reîncercați aceeași cerere intenționată
Utilizați o singură Idempotency-Key pentru fiecare operațiune intenționată și păstrați metoda, calea, parametrii de interogare și octeții corpului exact așa cum au fost trimiși. Cheile acceptă 1–128 de caractere ASCII imprimabile, fără spații. O cerere duplicată a cărei procesare este în curs poate returna 409 cu Retry-After. Cererile finalizate returnează din nou răspunsul memorat, inclusiv erorile. Respectați limitele de frecvență ale cererilor.
Un răspuns 502 memorat în cache poate apărea în urma unei erori de transport. Un răspuns 500 memorat î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 curente și clarificați situația împreună cu echipa de asistență înainte de a utiliza o cheie nouă. Nu presupuneți că eroarea înseamnă că nu există nicio comandă.