Kasutage kontole kuuluvat sõnumside kaubamärki
Kasutage lubatud lähte-IP-aadressilt aktiivset API kontot HTTPS kaudu. Toetatud on Basic ja Bearer autentimine. Kaubamärgi tunnus peab kuuluma sellele kontole. Hoidke teenusepakkujate pääsutõendid, kaubamärgi identiteediandmed ja tagastatud aruanded konfidentsiaalsena.
Tellige uus väline kontroll
Kasutage meetodit POST, kui kontrolliteenuse pakkuja peab selle kaubamärgi uuesti üle kontrollima. Kui teil on teenusepakkuja tulemus juba olemas, kasutage selle asemel importimist. See on eraldi toiming võrreldes kaubamärgi identiteedi uuesti kontrollimisega.
Lugege esmalt kaubamärgi praegused andmed ja kinnitage selle identiteediandmed. Valige toetatud teenusepakkuja ja klass kehtivatest kataloogidest ning kontrollige selle teenusepakkuja nõudeid. Kõik teenusepakkujad ei toeta kõiki klasse. Poliitilise kontrolli lisaandmed peavad kirjeldama tegelikku organisatsiooni või kampaaniat ega tohi olla näidisandmed.
Valmistage ette teenusepakkujale saadetav päring
| Väli | Väärtus |
|---|---|
| evpId | Kohustuslik teenusepakkuja tunnus kehtivast välise kontrolli teenusepakkujate kataloogist, 1–10 märki. |
| vettingClass | Toetatud klass, mida soovite osta; valige see selgesõnaliselt ja kinnitage selle hind. |
| additionalRequestPayload | JSON-vormingus kodeeritud string teenusepakkujapõhiste andmetega, mis on poliitilise kontrolli puhul kohustuslik. See on välimise JSON-objekti sees olev string, mitte pesastatud objekt. Täpsustage kõik nõutavad andmed valitud teenusepakkujaga. |
Kinnitage eduka ja ebaõnnestunud tulemuse tasud
Kehtivad jaehinnad USA dollarites, loetud 24. oktoobril 2026. Enne tegeliku tellimuse esitamist kinnitage kehtiv summa. Ettemaksu piisavust kontrollitakse eduka tulemuse hinna alusel; ostmine peab olema lubatud.
| Klass | Aktiivne tulemus | Ebaõnnestunud tulemus |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL koos Express-taotlusega | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Ootel tellimuste eduka ja ebaõnnestunud tulemuse summad säilitatakse ning arveldamine toimub tulemuse ACTIVE või FAILED sünkroonimisel. Kahe viimase klassi puhul kasutatakse mõlema lõpptulemuse korral sama seadistatud tasu. Kui lõpptulemus saabub kohe, võidakse tasu võtta juba tellimuse vastuse käigus. Hilisem oleku sünkroonimine võib viia ootel tasu arveldamiseni.
Ärge käsitage väärtust mock:true tasuta välise kontrolli garantiina. Praegune välise kontrolli arveldusprotsess võib selle tellimuse siiski registreerida ja selle eest tasu võtta. Need juhised ei nõua testimiseks tegelikku ostu; kasutage võrguühenduseta testiandmeid seni, kuni soovite tasulise kontrolli lubada.
Esitage üks ülevaadatud tellimus
Valmistage ette fail vetting-order.json, mis sisaldab teenusepakkuja tunnust, klassi ja kõiki nõutavaid lisaandmeid. Fail sisaldab tegelikku kavandatud päringut. Hoidke see konfidentsiaalsena.
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"Jälgige tegelikku tulemust
Edukas HTTP-vastus võib sisaldada ootel kontrollikirjet. Säilitage selle vettingId ning vaadake üle vettingStatus, põhjused, skoor ning jõustumis- ja aegumiskuupäevad, kui need on saadaval. PENDING ja UNSCORE nõuavad edasist jälgimist; ACTIVE, FAILED ja EXPIRED tähistavad erinevaid tulemusi. Üksnes vastuvõtmine HTTP tasemel ei tõenda soodsat skoori ega kampaania nõuetele vastavust.
Kasutage välise kontrolli olekut kirje jälgimiseks. Lõpptulemuse lugemine või importimine võib viia varasema tasulise tellimuse arveldamiseni; see ei pruugi olla vaba juba olemasolevast tasumata maksest.
Korrake sama kavandatud päringut
Kasutage iga kavandatud toimingu jaoks üht Idempotency-Key väärtust ning säilitage täpselt meetod, tee, päringuparameetrid ja sisu baidid. Võtmed toetavad 1–128 prinditavat ASCII märki ilma tühikuteta. Veel poolelioleva päringu duplikaat võib tagastada vastuse 409 koos päisega Retry-After. Lõpetatud päringute puhul tagastatakse uuesti nende salvestatud vastus, sealhulgas vead. Järgige päringusageduse piiranguid.
Transporditõrkele võib järgneda vahemällu salvestatud vastus 502. Vahemällu salvestatud vastus 500 koos väljaga requestId võib tähendada, et register võttis toimingu vastu, kuid kohalik püsisalvestus või arveldamine ebaõnnestus. Säilitage päringu tunnus, kontrollige praeguseid kirjeid ja selgitage olukord koos kasutajatoega välja enne uue võtme kasutamist. Ärge eeldage, et viga tähendab tellimuse puudumist.