Bruk en merkevare for meldingstjenester som tilhører kontoen
Bruk en aktivert API-konto over HTTPS fra en tillatt kilde-IP-adresse. Autentisering med Basic og Bearer støttes. Merkevare-ID-en må tilhøre denne kontoen. Hold leverandørtokener, merkevarens identitetsopplysninger og mottatte rapporter private.
Bestill en ny ekstern kontroll
Bruk POST når du trenger at en kontrollleverandør utfører en ny kontroll av denne merkevaren. Hvis du allerede har et resultat fra en leverandør, bruk import i stedet. Dette er en annen operasjon enn ny verifisering av merkevarens identitet.
Hent først merkevarens gjeldende opplysninger og bekreft identitetsopplysningene. Velg en støttet leverandør og klasse fra de gjeldende katalogene og sjekk kravene til den aktuelle leverandøren. Ikke alle leverandører støtter alle klasser. Tilleggsopplysninger for politisk kontroll må beskrive den faktiske organisasjonen eller kampanjen og må ikke være eksempeldata.
Klargjør forespørselen til leverandøren
| Felt | Verdi |
|---|---|
| evpId | Obligatorisk leverandør-ID fra den gjeldende katalogen over leverandører av ekstern kontroll, 1–10 tegn. |
| vettingClass | Den støttede klassen du har til hensikt å kjøpe; velg den uttrykkelig og bekreft prisen. |
| additionalRequestPayload | En JSON-kodet streng med leverandørspesifikke opplysninger, obligatorisk for politisk kontroll. Det er en streng inne i det ytre JSON-objektet, ikke et nestet objekt. Bekreft alle nødvendige opplysninger med den valgte leverandøren. |
Bekreft gebyrene ved vellykket og mislykket resultat
Gjeldende sluttkundegebyrer i amerikanske dollar, avlest 24. oktober 2026. Bekreft gjeldende beløp før du legger inn en reell bestilling. Forskuddsbetalte midler kontrolleres opp mot prisen for et vellykket resultat; kjøp må være aktivert.
| Klasse | Aktivt resultat | Mislykket resultat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL med Express-forespørsel | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Ventende bestillinger beholder beløpene for vellykket og mislykket resultat og gjøres opp når et resultat med ACTIVE eller FAILED synkroniseres. De to siste klassene bruker samme konfigurerte gebyr for begge endelige utfall. Et umiddelbart endelig resultat kan belastes når svaret på bestillingen behandles. Senere statussynkronisering kan gjøre opp en ventende belastning.
Ikke betrakt mock:true som et løfte om gratis ekstern kontroll. Den gjeldende oppgjørsprosessen for ekstern kontroll kan likevel registrere og belaste denne bestillingen. Disse instruksjonene krever ikke et reelt kjøp for testing; bruk frakoblede testdata inntil du har til hensikt å godkjenne en betalt kontroll.
Send inn én gjennomgått bestilling
Klargjør vetting-order.json med leverandør-ID, klasse og eventuelle nødvendige tilleggsopplysninger. Filen inneholder den faktiske forespørselen du har til hensikt å sende. Hold 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ølg det faktiske utfallet
Et vellykket HTTP-svar kan inneholde en ventende kontrolloppføring. Ta vare på oppføringens vettingId og undersøk vettingStatus, begrunnelser, poengsum og datoer for ikrafttredelse og utløp der disse er tilgjengelige. PENDING og UNSCORE krever videre oppfølging; ACTIVE, FAILED og EXPIRED beskriver ulike utfall. Aksept på HTTP-nivå alene beviser ikke en gunstig poengsum eller at kampanjen oppfyller kvalifikasjonskravene.
Bruk status for ekstern kontroll for å følge oppføringen. Henting eller import av et endelig resultat kan gjøre opp en tidligere betalt bestilling; det innebærer ikke nødvendigvis at en eksisterende utestående belastning bortfaller.
Prøv den samme tilsiktede forespørselen på nytt
Bruk én Idempotency-Key per tilsiktet operasjon, og behold nøyaktig samme metode, sti, spørring og byte i forespørselskroppen. Nøkler støtter 1–128 utskrivbare ASCII-tegn uten mellomrom. En duplikatforespørsel mens den opprinnelige behandles, kan returnere 409 med Retry-After. For fullførte forespørsler returneres det lagrede svaret på nytt, inkludert feil. Overhold grensene for forespørselsfrekvens.
Et mellomlagret 502-svar kan følge etter en transportfeil. Et mellomlagret 500-svar med requestId kan bety at registeret godtok operasjonen, men at lokal varig lagring eller fakturering mislyktes. Ta vare på forespørsels-ID-en, undersøk de gjeldende oppføringene og avklar status med kundestøtte før du bruker en ny nøkkel. Ikke anta at feilen betyr at ingen bestilling finnes.