Használjon a fiókhoz tartozó üzenetküldési márkát
Használjon engedélyezett API-fiókot HTTPS-kapcsolaton, engedélyezett forrás-IP-címről. A Basic és a Bearer hitelesítés támogatott. A márkaazonosítónak ehhez a fiókhoz kell tartoznia. Kezelje bizalmasan a szolgáltatói tokeneket, a márka azonosító adatait és a visszakapott jelentéseket.
Rendeljen új külső ellenőrzést
Használja a POST metódust, ha azt szeretné, hogy egy átvilágítási szolgáltató új ellenőrzést végezzen ezen a márkán. Ha már rendelkezik szolgáltatói eredménnyel, válassza inkább ezt: importálás. Ez külön művelet, nem azonos ezzel: a márka azonosító adatainak újbóli ellenőrzése.
Először kérje le a márka aktuális adatait, és erősítse meg az azonosító adatait. A támogatott szolgáltatót és osztályt innen válassza ki: aktuális katalógusok; majd ellenőrizze a szolgáltató követelményeit. Nem minden szolgáltató támogat minden osztályt. A politikai átvilágításhoz megadott további adatoknak a tényleges szervezetet vagy kampányt kell leírniuk, nem lehetnek mintaadatok.
Készítse elő a szolgáltatónak küldendő kérést
| Mező | Érték |
|---|---|
| evpId | Kötelező szolgáltatóazonosító a külső átvilágítási szolgáltatók aktuális katalógusából, 1–10 karakter. |
| vettingClass | A megvásárolni kívánt támogatott osztály; válassza ki kifejezetten, és ellenőrizze az árát. |
| additionalRequestPayload | JSON-kódolású karakterlánc szolgáltatóspecifikus adatokkal; politikai átvilágításhoz kötelező. A külső JSON-objektumon belüli karakterláncról van szó, nem beágyazott objektumról. Egyeztessen minden szükséges adatot a kiválasztott szolgáltatóval. |
Ellenőrizze a sikeres és sikertelen eredmény díjait
Aktuális kiskereskedelmi díjak amerikai dollárban, az október 24-i, 2026-os lekérdezés szerint. Valódi megrendelés leadása előtt ellenőrizze az aktuális összeget. Az előre feltöltött egyenleg fedezetét a sikeres eredmény díjához mérten ellenőrzik; a vásárlásoknak engedélyezve kell lenniük.
| Osztály | Aktív eredmény | Sikertelen eredmény |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL Express kéréssel | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
A függőben lévő megrendelések megőrzik a sikeres és sikertelen eredményhez tartozó összegeiket, és elszámolásuk az ACTIVE vagy FAILED eredmény szinkronizálásakor történik. Az utolsó két osztály esetében mindkét végleges eredményhez ugyanaz a beállított díj tartozik. Az azonnali végleges eredmény díját már a megrendelésre adott válasz során felszámíthatják. A későbbi állapotszinkronizálás elszámolhat egy függőben lévő díjat.
Ne tekintse a mock:true beállítást az ingyenes külső átvilágítás ígéretének. A külső átvilágítás jelenlegi elszámolási folyamata ettől még rögzítheti a megrendelést, és felszámíthatja annak díját. Ezek az utasítások nem követelnek meg valódi vásárlást a teszteléshez; használjon offline tesztadatokat addig, amíg szándékában nem áll fizetős ellenőrzést engedélyezni.
Küldjön be egy átnézett megrendelést
Készítse elő a vetting-order.json fájlt a szolgáltatóazonosítóval, az osztállyal és minden szükséges további adattal. A fájl a ténylegesen elküldeni kívánt kérést tartalmazza. Kezelje bizalmasan.
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"Kövesse nyomon a tényleges eredményt
A sikeres HTTP-válasz tartalmazhat függőben lévő átvilágítási rekordot. Őrizze meg a vettingId értékét, és tekintse át a vettingStatus értékét, az indokokat, a pontszámot, valamint az érvényesség kezdetének és lejáratának dátumát, amennyiben rendelkezésre állnak. A PENDING és az UNSCORE további nyomon követést igényel; az ACTIVE, a FAILED és az EXPIRED eltérő eredményeket jelöl. A HTTP szintjén történő elfogadás önmagában nem igazolja a kedvező pontszámot vagy a kampányra való jogosultságot.
Használja ezt: külső átvilágítás állapota a rekord nyomon követéséhez. Egy végleges eredmény lekérése vagy importálása elszámolhat egy korábbi fizetős megrendelést; nem feltétlenül mentes egy már fennálló, még el nem számolt díjtól.
Próbálja újra ugyanazt a tervezett kérést
Minden tervezett művelethez egy Idempotency-Key értéket használjon, és őrizze meg pontosan a metódust, az útvonalat, a lekérdezést és a törzs bájtjait. A kulcsok 1–128 nyomtatható ASCII-karakterből állhatnak, szóközök nélkül. Egy még folyamatban lévő kérés ismétlése 409 választ adhat Retry-After fejléccel. A befejezett kérések a tárolt válaszukat adják vissza újra, a hibákat is beleértve. Tartsa be a kérésgyakorisági korlátokat.
Átviteli hiba után gyorsítótárazott 502 válasz érkezhet. A requestId értéket tartalmazó, gyorsítótárazott 500 válasz azt jelentheti, hogy a nyilvántartás elfogadta a műveletet, de a helyi tartós tárolás vagy a számlázás sikertelen volt. Őrizze meg a kérésazonosítót, tekintse át az aktuális rekordokat, és egyeztessen az ügyfélszolgálattal, mielőtt új kulcsot használna. Ne feltételezze, hogy a hiba azt jelenti, hogy nem létezik megrendelés.