Përdorni një markë mesazhesh që i përket llogarisë
Përdorni një llogari API të aktivizuar përmes HTTPS, nga një adresë IP burimore e lejuar. Mbështetet autentikimi Basic dhe Bearer. Identifikuesi i markës duhet t'i përkasë asaj llogarie. Mbajini konfidenciale tokenët e ofruesve, të dhënat e identitetit të markës dhe raportet e kthyera.
Porositni një verifikim të ri të jashtëm
Përdorni POST kur ju duhet që një ofrues verifikimi të kryejë një verifikim të ri për këtë markë. Nëse keni tashmë një rezultat nga një ofrues, përdorni importimin në vend të kësaj. Ky veprim është i veçantë nga riverifikimi i identitetit të markës.
Së pari, lexoni të dhënat aktuale të markës dhe konfirmoni informacionin e identitetit të saj. Zgjidhni një ofrues dhe klasë të mbështetur nga katalogët aktualë dhe kontrolloni kërkesat e atij ofruesi. Jo çdo ofrues mbështet çdo klasë. Hollësitë shtesë për verifikimin politik duhet të përshkruajnë organizatën ose fushatën reale, jo të përmbajnë të dhëna shembull.
Përgatitni kërkesën për ofruesin
| Fusha | Vlera |
|---|---|
| evpId | Identifikuesi i detyrueshëm i ofruesit nga katalogu aktual i ofruesve të verifikimit të jashtëm, me 1–10 karaktere. |
| vettingClass | Klasa e mbështetur që synoni të blini; zgjidheni shprehimisht dhe konfirmoni çmimin e saj. |
| additionalRequestPayload | Një varg karakteresh i koduar në JSON, me hollësi specifike për ofruesin, i detyrueshëm për verifikimin politik. Është një varg karakteresh brenda objektit të jashtëm JSON, jo një objekt i ndërfutur. Konfirmoni të gjitha hollësitë e detyrueshme me ofruesin e zgjedhur. |
Konfirmoni tarifat për sukses dhe dështim
Tarifat aktuale me pakicë në dollarë amerikanë, të konsultuara më 24 tetor 2026. Konfirmoni shumën aktuale përpara se të bëni një porosi reale. Kontrollohet nëse fondet e parapaguara mbulojnë çmimin për sukses; blerjet duhet të jenë të aktivizuara.
| Klasa | Rezultat aktiv | Rezultat i dështuar |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL me kërkesë Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Porositë në pritje ruajnë shumat e tyre për sukses/dështim dhe shlyhen kur sinkronizohet një rezultat ACTIVE ose FAILED. Dy klasat e fundit përdorin të njëjtën tarifë të konfiguruar për cilindo rezultat përfundimtar. Një rezultat përfundimtar i menjëhershëm mund të tarifohet gjatë përgjigjes ndaj porosisë. Sinkronizimi i mëvonshëm i statusit mund të shlyejë një tarifë në pritje.
Mos e konsideroni mock:true si garanci për verifikim të jashtëm falas. Rrjedha aktuale e shlyerjes së verifikimit të jashtëm ende mund ta regjistrojë dhe ta tarifojë atë porosi. Këto udhëzime nuk kërkojnë blerje reale për testim; përdorni grupe të dhënash testimi jashtë linje derisa të synoni të autorizoni një verifikim me pagesë.
Dërgoni një porosi të vetme të shqyrtuar
Përgatitni vetting-order.json me identifikuesin e ofruesit, klasën dhe çdo informacion shtesë të detyrueshëm. Skedari përmban kërkesën reale që synoni të dërgoni. Mbajeni konfidencial.
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"Ndiqni rezultatin real
Një përgjigje e suksesshme HTTP mund të përmbajë një regjistrim verifikimi në pritje. Ruani vlerën e tij vettingId dhe shqyrtoni vettingStatus, arsyet, pikëzimin dhe datat e hyrjes në fuqi/skadimit, kur janë të disponueshme. PENDING dhe UNSCORE kërkojnë ndjekje të mëtejshme; ACTIVE, FAILED dhe EXPIRED përshkruajnë rezultate të ndryshme. Vetëm pranimi HTTP nuk provon një pikëzim të favorshëm apo plotësimin e kushteve të pranueshmërisë së fushatës.
Përdorni statusin e verifikimit të jashtëm për të ndjekur regjistrimin. Leximi ose importimi i një rezultati përfundimtar mund të shlyejë një porosi të mëparshme me pagesë; ky veprim nuk është domosdoshmërisht i përjashtuar nga një tarifë ekzistuese ende e papaguar.
Riprovoni të njëjtën kërkesë të synuar
Përdorni një Idempotency-Key për çdo veprim të synuar dhe ruani saktësisht metodën, shtegun, parametrat e kërkimit dhe bajtet e trupit të kërkesës. Çelësat mbështesin 1–128 karaktere ASCII të printueshme pa hapësira. Një dublikatë e një kërkese në proces mund të kthejë 409 me Retry-After. Kërkesat e përfunduara rikthejnë përgjigjen e tyre të ruajtur, përfshirë gabimet. Respektoni kufijtë e shpeshtësisë së kërkesave.
Një përgjigje 502 e ruajtur në memorien e përkohshme mund të pasojë një dështim të transportit. Një përgjigje 500 e ruajtur në memorien e përkohshme me requestId mund të nënkuptojë se regjistri e ka pranuar veprimin, por ruajtja lokale ose faturimi ka dështuar. Ruani identifikuesin e kërkesës, shqyrtoni regjistrimet aktuale dhe sqaroni situatën me mbështetjen përpara se të përdorni një çelës të ri. Mos supozoni se gabimi do të thotë që nuk ekziston asnjë porosi.