Použijte značku pro zasílání zpráv patřící danému účtu
Použijte aktivovaný úč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í.
Použijte existující výsledek od poskytovatele
Pomocí PUT přiřaďte ke své značce existující výsledek prověření od podporovaného poskytovatele. Tím se neobjednává nové prověření. Správné ID transakce poskytovatele a případný potvrzovací token získejte přímo od tohoto poskytovatele a ujistěte se, že se zpráva vztahuje ke stejnému podnikatelskému subjektu.
AUTHPLUS tento postup importu nepodporuje. Nadále platí pravidla jednotlivých poskytovatelů pro ověřování shody; požadavek na import je neruší ani nezaručuje způsobilost pro každý způsob využití kampaně.
Připravte import
| Pole | Hodnota |
|---|---|
| evpId | ID podporovaného poskytovatele, 1–10 znaků. |
| vettingId | Skutečný identifikátor transakce prověření u poskytovatele, nejvýše 255 znaků. Nenahrazujte jej ID značky ani si identifikátor nevymýšlejte. |
| vettingToken | Potvrzovací token, pokud jej poskytovatel vyžaduje, nejvýše 65535 znaků. Zacházejte s ním jako s tajným údajem a vynechte jej, pokud jej poskytovatel nevyžaduje. |
Vytvořte soubor vetting-import.json se skutečnými hodnotami od poskytovatele. Neodesílejte pole se skóre, stavem nebo časovými razítky určená pouze pro odpověď, jako by mohla změnit výsledek.
Importujte výsledek pouze jednou
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Seznamte se se stávajícími poplatky
Tento proxy server nezaznamenává nově importovaný výsledek jako novou placenou objednávku. Tím se neruší dříve objednané prověření: pokud již pro stejné vettingId existuje objednávka čekající na výsledek nebo na zaúčtování poplatku, import výsledku ACTIVE nebo FAILED může vést k vyúčtování jejího uloženého poplatku. Tato větev synchronizace znovu neúčtuje poplatek za záznam, který již byl zpoplatněn.
Sledujte skutečný výsledek
Úspěšná odpověď HTTP může obsahovat záznam dosud nedokončeného prověření. Uchovejte jeho vettingId a zkontrolujte vettingStatus, důvody, skóre a data začátku a konce platnosti, pokud jsou k dispozici. Stavy PENDING a UNSCORE vyžadují další sledování; ACTIVE, FAILED a EXPIRED označují různé výsledky. Samotné přijetí na úrovni HTTP nedokládá příznivé skóre ani způsobilost pro kampaň.
Použijte stav externího prověření ke sledování záznamu. Načtení nebo import konečného výsledku může vést k vyúčtování dřívější placené objednávky; nemusí tedy být bez úhrady již existujícího nevyrovnané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 i 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 požadavku 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.