Upotrijebite robnu marku za slanje poruka koja pripada računu
Upotrijebite omogućen API račun putem protokola HTTPS s dopuštene izvorne IP adrese. Podržana je autentifikacija Basic i Bearer. ID robne marke mora pripadati tom računu. Tokene pružatelja, podatke o identitetu robne marke i vraćena izvješća čuvajte kao povjerljive podatke.
Naručite novu vanjsku provjeru
Upotrijebite POST kada želite da pružatelj provjere provede novu provjeru ove robne marke. Ako već imate rezultat pružatelja, upotrijebite uvoz umjesto toga. To je odvojeno od postupka ponovne provjere identiteta robne marke.
Najprije dohvatite trenutačne podatke o robnoj marki i potvrdite podatke o njezinu identitetu. Odaberite podržanog pružatelja i klasu iz trenutačnih kataloga i provjerite zahtjeve tog pružatelja. Ne podržava svaki pružatelj svaku klasu. Dodatni podaci za političku provjeru moraju opisivati stvarnu organizaciju ili kampanju, a ne biti ogledni podaci.
Pripremite zahtjev za pružatelja
| Polje | Vrijednost |
|---|---|
| evpId | Obvezni ID pružatelja iz trenutačnog kataloga pružatelja vanjske provjere, 1–10 znakova. |
| vettingClass | Podržana klasa koju namjeravate kupiti; izričito je odaberite i potvrdite njezinu cijenu. |
| additionalRequestPayload | Niz znakova kodiran u formatu JSON s podacima specifičnima za pružatelja, obvezan za političku provjeru. To je niz znakova unutar vanjskog objekta JSON, a ne ugniježđeni objekt. Potvrdite sve potrebne podatke s odabranim pružateljem. |
Potvrdite naknade za uspješnu i neuspješnu provjeru
Trenutačne maloprodajne naknade u američkim dolarima, očitane 24. listopada 2026. Potvrdite trenutačni iznos prije slanja stvarne narudžbe. Unaprijed uplaćena sredstva provjeravaju se u odnosu na cijenu uspješne provjere; kupnje moraju biti omogućene.
| Klasa | Aktivan rezultat | Neuspješan rezultat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL uz zahtjev Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Narudžbe na čekanju zadržavaju svoje iznose za uspjeh i neuspjeh te se obračunavaju kada se sinkronizira rezultat ACTIVE ili FAILED. Posljednje dvije klase upotrebljavaju istu postavljenu naknadu za oba konačna ishoda. Ako je konačni rezultat dostupan odmah, naplata se može izvršiti tijekom obrade odgovora na narudžbu. Naknadna sinkronizacija statusa može podmiriti naplatu na čekanju.
Nemojte smatrati mock:true jamstvom besplatne vanjske provjere. Trenutačni postupak obračuna vanjske provjere i dalje može evidentirati i naplatiti tu narudžbu. Ove upute ne zahtijevaju stvarnu kupnju radi testiranja; upotrebljavajte pripremljene testne podatke bez mrežne veze dok ne budete namjeravali odobriti provjeru koja se plaća.
Pošaljite jednu pregledanu narudžbu
Pripremite vetting-order.json s ID-jem pružatelja, klasom i svim obveznim dodatnim podacima. Datoteka sadrži stvarni zahtjev koji namjeravate poslati. Čuvajte je kao povjerljivu.
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"Pratite stvarni ishod
Uspješan odgovor HTTP može sadržavati zapis provjere na čekanju. Sačuvajte njegov vettingId i pregledajte vettingStatus, razloge, ocjenu te datume početka i isteka valjanosti ako su dostupni. PENDING i UNSCORE zahtijevaju daljnje praćenje; ACTIVE, FAILED i EXPIRED opisuju različite ishode. Samo prihvaćanje putem protokola HTTP ne dokazuje povoljnu ocjenu ni ispunjavanje uvjeta za kampanju.
Upotrijebite status vanjske provjere za praćenje zapisa. Dohvaćanje ili uvoz konačnog rezultata može podmiriti raniju narudžbu koja se naplaćuje; pritom nije nužno isključena naplata postojećeg nepodmirenog iznosa.
Ponovno pokušajte poslati isti namjeravani zahtjev
Upotrijebite jedan Idempotency-Key po namjeravanoj operaciji i sačuvajte potpuno iste bajtove metode, putanje, upita i tijela zahtjeva. Ključevi podržavaju 1–128 ispisivih znakova ASCII bez razmaka. Duplikat zahtjeva koji je u tijeku može vratiti 409 uz Retry-After. Za dovršene zahtjeve ponovno se vraća njihov pohranjeni odgovor, uključujući pogreške. Poštujte ograničenja učestalosti zahtjeva.
Nakon pogreške u prijenosu može uslijediti odgovor 502 iz predmemorije. Odgovor 500 iz predmemorije s requestId može značiti da je registar prihvatio operaciju, ali lokalna pohrana ili naplata nije uspjela. Sačuvajte ID zahtjeva, pregledajte trenutačne zapise i razjasnite stanje s podrškom prije upotrebe novog ključa. Nemojte pretpostaviti da pogreška znači da narudžba ne postoji.