Použijte značku pro zasílání zpráv, která patří danému účtu
Použijte povolený účet API přes HTTPS z povolené zdrojové IP adresy. Podporováno je ověřování Basic a Bearer. ID značky musí patřit tomuto účtu. Tokeny poskytovatele, identifikační údaje značky a vrácené zprávy uchovávejte v soukromí.
Objednejte novou externí prověrku
Použijte POST, pokud potřebujete, aby poskytovatel prověrek provedl novou prověrku této značky. Pokud již máte výsledek od poskytovatele, použijte místo toho import. Jde o jinou operaci než opětovné ověření identity značky.
Nejprve načtěte aktuální údaje značky a potvrďte její identifikační údaje. Vyberte podporovaného poskytovatele a třídu z aktuálních katalogů a ověřte požadavky daného poskytovatele. Ne každý poskytovatel podporuje všechny třídy. Doplňující údaje pro politickou prověrku musí popisovat skutečnou organizaci nebo kampaň; nesmí jít o vzorová data.
Připravte požadavek pro poskytovatele
| Pole | Hodnota |
|---|---|
| evpId | Povinné ID poskytovatele z aktuálního katalogu poskytovatelů externích prověrek, 1–10 znaků. |
| vettingClass | Podporovaná třída, kterou hodláte zakoupit; zvolte ji výslovně a potvrďte její cenu. |
| additionalRequestPayload | Řetězec zakódovaný ve formátu JSON s údaji specifickými pro poskytovatele, který je povinný pro politickou prověrku. Jde o řetězec uvnitř vnějšího objektu JSON, nikoli o vnořený objekt. Všechny požadované údaje ověřte u vybraného poskytovatele. |
Potvrďte poplatky za úspěšný i neúspěšný výsledek
Aktuální maloobchodní poplatky v amerických dolarech, zjištěné dne 24. října 2026. Před zadáním skutečné objednávky potvrďte aktuální částku. Dostatek předplacených prostředků se kontroluje podle ceny za úspěšný výsledek; nákupy musí být povolené.
| Třída | Aktivní výsledek | Neúspěšný výsledek |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL s požadavkem Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
U čekajících objednávek zůstávají zachovány částky za úspěšný i neúspěšný výsledek a k vyúčtování dojde při synchronizaci výsledku ACTIVE nebo FAILED. U posledních dvou tříd je pro oba konečné výsledky nastaven stejný poplatek. Pokud je konečný výsledek k dispozici okamžitě, může být poplatek účtován již při odpovědi na objednávku. Pozdější synchronizace stavu může vypořádat dosud nevyúčtovaný poplatek.
Nepovažujte mock:true za příslib bezplatné externí prověrky. Současný postup vyúčtování externích prověrek může i tak tuto objednávku zaznamenat a zpoplatnit. Tyto pokyny nevyžadují pro testování skutečný nákup; dokud nehodláte schválit placenou prověrku, používejte offline testovací data.
Odešlete jednu zkontrolovanou objednávku
Připravte soubor vetting-order.json s ID poskytovatele, třídou a všemi požadovanými doplňujícími údaji. Soubor obsahuje skutečný požadavek, který hodláte odeslat. Uchovávejte jej v soukromí.
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"Sledujte skutečný výsledek
Úspěšná odpověď HTTP může obsahovat záznam o dosud nedokončené prověrce. Uchovejte jeho vettingId a zkontrolujte vettingStatus, důvody, skóre a data počátku a konce platnosti, pokud jsou k dispozici. Stavy PENDING a UNSCORE vyžadují další sledování; ACTIVE, FAILED a EXPIRED popisují různé výsledky. Samotné přijetí na úrovni HTTP nedokazuje příznivé skóre ani způsobilost kampaně.
Použijte stav externí prověrky ke sledování záznamu. Načtení nebo import konečného výsledku může vyúčtovat dřívější placenou objednávku; nemusí tedy být bez účtování již existujícího neuhrazeného poplatku.
Opakujte tentýž zamýšlený požadavek
Pro každou zamýšlenou operaci použijte jeden Idempotency-Key a zachovejte přesnou metodu, cestu, dotaz a bajty těla požadavku. Klíče podporují 1–128 tisknutelných znaků ASCII bez mezer. Duplicitní požadavek během zpracování původního může vrátit 409 s Retry-After. U dokončených požadavků se znovu vrací uložená odpověď včetně chyb. Dodržujte limity četnosti požadavků.
Po selhání přenosu může následovat odpověď 502 uložená v mezipaměti. Odpověď 500 uložená v mezipaměti s requestId může znamenat, že registr operaci přijal, ale místní trvalé uložení nebo účtování selhalo. Uchovejte ID požadavku, zkontrolujte aktuální záznamy a před použitím nového klíče vyjasněte stav s podporou. Nepředpokládejte, že chyba znamená, že žádná objednávka neexistuje.