Izmantojiet kontam piederošu ziņapmaiņas zīmolu
Izmantojiet iespējotu API kontu, pieslēdzoties ar HTTPS no atļautas avota IP adreses. Tiek atbalstīta Basic un Bearer autentifikācija. Zīmola identifikatoram jāpieder šim kontam. Nodrošiniet pakalpojumu sniedzēju pilnvaru, zīmola identitātes datu un saņemto pārskatu konfidencialitāti.
Pasūtiet jaunu ārējo pārbaudi
Izmantojiet POST, ja pārbaudes pakalpojuma sniedzējam jāveic jauna šī zīmola pārbaude. Ja jums jau ir pakalpojuma sniedzēja rezultāts, tā vietā izmantojiet importēšanu. Tā ir atsevišķa darbība no zīmola identitātes atkārtotas pārbaudes.
Vispirms nolasiet pašreizējos zīmola datus un apstipriniet tā identitātes informāciju. Izvēlieties atbalstītu pakalpojuma sniedzēju un klasi no aktuālajiem katalogiem un pārbaudiet šī pakalpojuma sniedzēja prasības. Ne katrs pakalpojuma sniedzējs atbalsta visas klases. Politiskajai pārbaudei nepieciešamajai papildinformācijai jāapraksta faktiskā organizācija vai kampaņa, nevis jāietver parauga dati.
Sagatavojiet pieprasījumu pakalpojuma sniedzējam
| Lauks | Vērtība |
|---|---|
| evpId | Obligāts pakalpojuma sniedzēja identifikators no aktuālā ārējās pārbaudes pakalpojumu sniedzēju kataloga, 1–10 rakstzīmes. |
| vettingClass | Atbalstītā klase, kuru plānojat iegādāties; izvēlieties to nepārprotami un apstipriniet tās cenu. |
| additionalRequestPayload | JSON formātā kodēta virkne ar konkrētam pakalpojuma sniedzējam nepieciešamo informāciju; tā ir obligāta politiskajai pārbaudei. Tā ir virkne ārējā JSON objektā, nevis ligzdots objekts. Visu nepieciešamo informāciju precizējiet pie izvēlētā pakalpojuma sniedzēja. |
Apstipriniet maksas par sekmīgu un nesekmīgu rezultātu
Pašreizējās mazumtirdzniecības maksas ASV dolāros, nolasītas 24. oktobrī 2026. gadā. Pirms reāla pasūtījuma veikšanas apstipriniet aktuālo summu. Priekšapmaksas līdzekļu pietiekamību pārbauda atbilstoši sekmīga rezultāta cenai; pirkumiem jābūt iespējotiem.
| Klase | Aktīvs rezultāts | Nesekmīgs rezultāts |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL ar Express pieprasījumu | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Neizpildītiem pasūtījumiem tiek saglabātas summas par sekmīgu un nesekmīgu rezultātu, un norēķins tiek veikts, sinhronizējot rezultātu ACTIVE vai FAILED. Pēdējām divām klasēm abiem gala rezultātiem ir konfigurēta vienāda maksa. Ja gala rezultāts ir pieejams uzreiz, maksu var iekasēt pasūtījuma atbildes laikā. Vēlāka statusa sinhronizācija var nokārtot vēl neiekasētu maksu.
Neuzskatiet mock:true par garantiju, ka ārējā pārbaude būs bez maksas. Pašreizējais ārējās pārbaudes norēķinu process joprojām var reģistrēt šo pasūtījumu un iekasēt par to maksu. Šie norādījumi neprasa testēšanai veikt reālu pirkumu; izmantojiet bezsaistes testa datus, līdz plānojat atļaut maksas pārbaudi.
Iesniedziet vienu pārskatītu pasūtījumu
Sagatavojiet failu vetting-order.json ar pakalpojuma sniedzēja identifikatoru, klasi un visu nepieciešamo papildinformāciju. Fails satur faktisko paredzēto pieprasījumu. Nodrošiniet tā konfidencialitāti.
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"Sekojiet faktiskajam rezultātam
Sekmīga HTTP atbilde var saturēt vēl nepabeigtas pārbaudes ierakstu. Saglabājiet tā vettingId un pārbaudiet vettingStatus, iemeslus, vērtējumu un spēkā stāšanās un beigu datumus, ja tie ir pieejami. PENDING un UNSCORE prasa turpmāku sekošanu; ACTIVE, FAILED un EXPIRED apzīmē atšķirīgus rezultātus. Pieņemšana HTTP līmenī pati par sevi neapliecina labvēlīgu vērtējumu vai kampaņas atbilstību nosacījumiem.
Izmantojiet ārējās pārbaudes statusu, lai sekotu ierakstam. Gala rezultāta nolasīšana vai importēšana var izraisīt norēķinu par agrāk veiktu maksas pasūtījumu; tas ne vienmēr nozīmē, ka netiks iekasēta jau esoša nesamaksāta maksa.
Atkārtojiet to pašu paredzēto pieprasījumu
Katrai paredzētajai darbībai izmantojiet vienu Idempotency-Key un saglabājiet precīzu metodi, ceļu, vaicājumu un satura baitus. Atslēgās var būt 1–128 drukājamas ASCII rakstzīmes bez atstarpēm. Dublikāts, kura apstrāde vēl turpinās, var atgriezt 409 ar Retry-After. Pabeigtiem pieprasījumiem tiek atkārtoti atgriezta saglabātā atbilde, tostarp kļūdas. Ievērojiet pieprasījumu biežuma ierobežojumus.
Pēc transporta kļūmes var tikt saglabāta kešota 502 atbilde. Kešota 500 atbilde ar requestId var nozīmēt, ka reģistrs pieņēma darbību, taču vietējā datu saglabāšana vai norēķinu apstrāde neizdevās. Saglabājiet pieprasījuma identifikatoru, pārbaudiet pašreizējos ierakstus un pirms jaunas atslēgas izmantošanas saskaņojiet situāciju ar atbalsta dienestu. Nepieņemiet, ka kļūda nozīmē pasūtījuma neesamību.