Använd ett meddelandevarumärke som tillhör kontot
Använd ett aktiverat API-konto via HTTPS från en tillåten käll-IP-adress. Autentisering med Basic och Bearer stöds. Varumärkes-ID:t måste tillhöra det kontot. Håll leverantörstoken, varumärkets identitetsuppgifter och returnerade rapporter privata.
Beställ en ny extern granskning
Använd POST när en granskningsleverantör ska utföra en ny granskning av det här varumärket. Om du redan har ett resultat från en leverantör använder du import i stället. Detta är en separat åtgärd från förnyad verifiering av varumärkets identitet.
Läs först in det aktuella varumärket och bekräfta dess identitetsuppgifter. Välj en kombination av leverantör och klass som stöds från de aktuella katalogerna och kontrollera den leverantörens krav. Alla leverantörer stöder inte alla klasser. Ytterligare uppgifter för politisk granskning måste beskriva den faktiska organisationen eller kampanjen och får inte vara exempeldata.
Förbered begäran till leverantören
| Fält | Värde |
|---|---|
| evpId | Obligatoriskt leverantörs-ID från den aktuella katalogen över leverantörer av extern granskning, 1–10 tecken. |
| vettingClass | Den klass som stöds och som du avser att köpa; välj den uttryckligen och bekräfta priset. |
| additionalRequestPayload | En JSON-kodad sträng med leverantörsspecifika uppgifter, obligatorisk för politisk granskning. Det är en sträng i det yttre JSON-objektet, inte ett nästlat objekt. Bekräfta alla obligatoriska uppgifter med den valda leverantören. |
Bekräfta avgifterna vid lyckat och misslyckat resultat
Aktuella slutkundsavgifter i amerikanska dollar, avlästa den 24 oktober 2026. Bekräfta det aktuella beloppet innan du gör en verklig beställning. Det förbetalda saldot kontrolleras mot priset för ett lyckat resultat; köp måste vara aktiverade.
| Klass | Aktivt resultat | Misslyckat resultat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL med Express-begäran | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Väntande beställningar behåller sina belopp för lyckat respektive misslyckat resultat och slutregleras när ett resultat med status ACTIVE eller FAILED synkroniseras. De två sista klasserna har samma konfigurerade avgift för båda slutliga utfallen. Ett omedelbart slutligt resultat kan debiteras i samband med beställningssvaret. En senare statussynkronisering kan slutreglera en väntande debitering.
Se inte mock:true som ett löfte om kostnadsfri extern granskning. Den nuvarande processen för slutreglering av extern granskning kan ändå registrera och debitera den beställningen. Dessa anvisningar kräver inget verkligt köp för testning; använd förberedda testdata offline tills du avser att godkänna en avgiftsbelagd granskning.
Skicka en beställning som har granskats
Förbered vetting-order.json med leverantörs-ID, klass och eventuella obligatoriska tilläggsuppgifter. Filen innehåller den faktiska begäran som du avser att skicka. Håll den privat.
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"Följ det faktiska utfallet
Ett lyckat HTTP-svar kan innehålla en väntande granskningspost. Spara dess vettingId och kontrollera vettingStatus, orsaker, poäng samt start- och slutdatum för giltigheten i den mån de finns tillgängliga. PENDING och UNSCORE kräver fortsatt uppföljning; ACTIVE, FAILED och EXPIRED beskriver olika utfall. Enbart ett godkännande på HTTP-nivå bevisar inte att poängen är gynnsam eller att villkoren för en kampanj är uppfyllda.
Använd status för extern granskning för att följa posten. Att läsa eller importera ett slutligt resultat kan slutreglera en tidigare avgiftsbelagd beställning; det innebär inte nödvändigtvis att en befintlig utestående avgift inte debiteras.
Försök igen med samma avsedda begäran
Använd en Idempotency-Key per avsedd åtgärd och bevara exakt samma metod, sökväg, frågesträng och byte i begärans kropp. Nycklar stöder 1–128 utskrivbara ASCII-tecken utan blanksteg. En dubblett av en pågående begäran kan returnera 409 med Retry-After. För slutförda begäranden returneras det lagrade svaret igen, inklusive fel. Följ gränserna för anropsfrekvens.
Ett cachelagrat 502-svar kan följa på ett överföringsfel. Ett cachelagrat 500-svar med requestId kan betyda att registret accepterade åtgärden men att lokal lagring eller fakturering misslyckades. Spara begärans ID, kontrollera de aktuella posterna och stäm av med supporten innan du använder en ny nyckel. Anta inte att felet betyder att ingen beställning finns.