Brug et beskedbrand, der tilhører kontoen
Brug en aktiveret API-konto via HTTPS fra en tilladt kilde-IP-adresse. Godkendelse med Basic og Bearer understøttes. Brandets ID skal tilhøre den pågældende konto. Hold udbydertokens, brandets identitetsoplysninger og de returnerede rapporter fortrolige.
Bestil en ny ekstern kontrol
Brug POST, når du har brug for, at en kontroludbyder udfører en ny kontrol af dette brand. Hvis du allerede har et resultat fra en udbyder, skal du bruge import i stedet. Dette er adskilt fra fornyet bekræftelse af brandets identitet.
Hent først de aktuelle oplysninger om brandet, og bekræft dets identitetsoplysninger. Vælg en understøttet udbyder og klasse fra de aktuelle kataloger og gennemgå den pågældende udbyders krav. Ikke alle udbydere understøtter alle klasser. Supplerende oplysninger til politisk kontrol skal beskrive den faktiske organisation eller kampagne og må ikke være eksempeldata.
Forbered anmodningen til udbyderen
| Felt | Værdi |
|---|---|
| evpId | Påkrævet udbyder-ID fra det aktuelle katalog over udbydere af ekstern kontrol, 1–10 tegn. |
| vettingClass | Den understøttede klasse, du vil købe; vælg den udtrykkeligt, og bekræft dens pris. |
| additionalRequestPayload | En JSON-kodet streng med udbyderspecifikke oplysninger, som er påkrævet ved politisk kontrol. Det er en streng i det ydre JSON-objekt, ikke et indlejret objekt. Bekræft alle påkrævede oplysninger hos den valgte udbyder. |
Bekræft gebyrerne ved vellykket og mislykket kontrol
Aktuelle slutkundegebyrer i amerikanske dollar, aflæst den 24. oktober 2026. Bekræft det aktuelle beløb, før du afgiver en reel bestilling. Den forudbetalte saldo kontrolleres i forhold til prisen for en vellykket kontrol; køb skal være aktiveret.
| Klasse | Aktivt resultat | Mislykket resultat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL med Express-anmodning | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Afventende bestillinger beholder deres beløb for vellykket og mislykket kontrol og afregnes, når et resultat med status ACTIVE eller FAILED synkroniseres. De sidste to klasser bruger det samme konfigurerede gebyr for begge endelige udfald. Et øjeblikkeligt endeligt resultat kan blive opkrævet, mens bestillingssvaret behandles. Senere statussynkronisering kan afregne en afventende opkrævning.
Brug ikke mock:true som en garanti for gratis ekstern kontrol. Den nuværende afregningsproces for ekstern kontrol kan stadig registrere og opkræve betaling for den pågældende bestilling. Disse instruktioner kræver ikke et reelt køb til test; brug lokale testdata uden netværksforbindelse, indtil du har til hensigt at godkende en kontrol mod betaling.
Indsend én gennemgået bestilling
Klargør vetting-order.json med udbyder-ID, klasse og eventuelle påkrævede supplerende oplysninger. Filen indeholder den faktiske anmodning, du har til hensigt at sende. Hold den fortrolig.
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ølg det faktiske udfald
Et vellykket HTTP-svar kan indeholde en afventende kontrolpost. Gem dens vettingId, og gennemgå vettingStatus, begrundelser, vurdering samt ikrafttrædelses- og udløbsdatoer, i det omfang de er tilgængelige. PENDING og UNSCORE kræver yderligere opfølgning; ACTIVE, FAILED og EXPIRED beskriver forskellige udfald. Accept via HTTP alene dokumenterer ikke en gunstig vurdering eller berettigelse til en kampagne.
Brug status for ekstern kontrol til at følge posten. Hentning eller import af et endeligt resultat kan afregne en tidligere bestilling mod betaling; handlingen er ikke nødvendigvis uden opkrævning af et allerede udestående beløb.
Gentag den samme tilsigtede anmodning
Brug én Idempotency-Key pr. tilsigtet handling, og bevar nøjagtigt de samme bytes for metode, sti, forespørgsel og indhold. Nøgler understøtter 1–128 udskrivbare ASCII-tegn uden mellemrum. En dublet af en igangværende anmodning kan returnere 409 med Retry-After. Afsluttede anmodninger returnerer deres gemte svar igen, inklusive fejl. Overhold grænserne for anmodningsfrekvens.
Et cachelagret 502-svar kan følge efter en transportfejl. Et cachelagret 500-svar med requestId kan betyde, at registret accepterede handlingen, men at lokal lagring eller fakturering mislykkedes. Gem anmodningens ID, undersøg de aktuelle poster, og afklar forløbet med support, før du bruger en ny nøgle. Antag ikke, at fejlen betyder, at der ikke findes en bestilling.