Gebruik een berichtenmerk dat eigendom is van het account
Gebruik een ingeschakeld API-account via HTTPS vanaf een toegestaan bron-IP-adres. Authenticatie met Basic en Bearer wordt ondersteund. De merk-ID moet bij dat account horen. Houd tokens van aanbieders, identiteitsgegevens van het merk en ontvangen rapporten vertrouwelijk.
Bestel een nieuwe externe controle
Gebruik POST wanneer een controleaanbieder een nieuwe controle voor dit merk moet uitvoeren. Hebt u al een resultaat van een aanbieder, gebruik dan importeren in plaats daarvan. Dit staat los van het opnieuw verifiëren van de merkidentiteit.
Haal eerst de huidige merkgegevens op en bevestig de identiteitsgegevens. Kies een ondersteunde combinatie van aanbieder en klasse uit de actuele catalogi en controleer de vereisten van die aanbieder. Niet elke aanbieder ondersteunt elke klasse. Aanvullende gegevens voor politieke controles moeten de daadwerkelijke organisatie of campagne beschrijven en mogen geen voorbeeldgegevens zijn.
Bereid het verzoek aan de aanbieder voor
| Veld | Waarde |
|---|---|
| evpId | Verplichte aanbieder-ID uit de actuele catalogus van aanbieders van externe controles, 1–10 tekens. |
| vettingClass | De ondersteunde klasse die u wilt aanschaffen; kies deze expliciet en bevestig de prijs. |
| additionalRequestPayload | Een als JSON gecodeerde tekenreeks met aanbiederafhankelijke gegevens, verplicht voor politieke controles. Dit is een tekenreeks binnen het buitenste JSON-object, geen genest object. Stem alle vereiste gegevens af met de gekozen aanbieder. |
Bevestig de kosten bij slagen en mislukken
Actuele eindgebruikerstarieven in Amerikaanse dollars, geraadpleegd op 24 oktober 2026. Bevestig het actuele bedrag voordat u een echte bestelling plaatst. Het vooruitbetaalde saldo wordt getoetst aan de prijs bij slagen; aankopen moeten zijn ingeschakeld.
| Klasse | Actief resultaat | Mislukt resultaat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL met een Express-verzoek | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Bij openstaande bestellingen blijven de bedragen voor slagen en mislukken bewaard; de afrekening vindt plaats wanneer een resultaat met ACTIVE of FAILED wordt gesynchroniseerd. Voor de laatste twee klassen geldt voor beide definitieve uitkomsten hetzelfde ingestelde tarief. Als er direct een definitief resultaat is, kunnen de kosten tijdens het verwerken van het bestelantwoord in rekening worden gebracht. Latere statussynchronisatie kan een openstaand bedrag afrekenen.
Beschouw mock:true niet als een garantie op een gratis externe controle. De huidige afrekenprocedure voor externe controles kan die bestelling nog steeds vastleggen en in rekening brengen. Deze instructies vereisen geen echte aankoop om te testen; gebruik offline testgegevens totdat u een betaalde controle wilt autoriseren.
Dien één gecontroleerde bestelling in
Bereid vetting-order.json voor met de aanbieder-ID, de klasse en alle vereiste aanvullende informatie. Het bestand bevat het daadwerkelijke verzoek dat u wilt indienen. Houd het vertrouwelijk.
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"Volg de daadwerkelijke uitkomst
Een geslaagd HTTP-antwoord kan een controlerecord bevatten dat nog in behandeling is. Bewaar de bijbehorende vettingId en bekijk vettingStatus, redenen, score en ingangs- en vervaldatums voor zover beschikbaar. PENDING en UNSCORE vereisen verdere opvolging; ACTIVE, FAILED en EXPIRED beschrijven verschillende uitkomsten. Acceptatie op HTTP-niveau alleen bewijst geen gunstige score of geschiktheid van de campagne.
Gebruik de status van de externe controle om het record te volgen. Het ophalen of importeren van een definitief resultaat kan een eerdere betaalde bestelling afrekenen; daarbij kan dus nog een bestaand openstaand bedrag in rekening worden gebracht.
Probeer hetzelfde beoogde verzoek opnieuw
Gebruik één Idempotency-Key per beoogde bewerking en bewaar de exacte methode, het pad, de query en de bytes van de berichtinhoud. Sleutels ondersteunen 1–128 afdrukbare ASCII-tekens zonder spaties. Een duplicaat van een verzoek dat nog wordt verwerkt, kan 409 met Retry-After opleveren. Voor voltooide verzoeken wordt het opgeslagen antwoord opnieuw teruggegeven, inclusief fouten. Houd u aan de limieten voor het aantal verzoeken.
Na een transportfout kan een gecachet antwoord met 502 volgen. Een gecachet antwoord met 500 en requestId kan betekenen dat het register de bewerking heeft geaccepteerd, maar dat de lokale opslag of facturering is mislukt. Bewaar de verzoek-ID, bekijk de huidige records en stem de stand van zaken af met de ondersteuning voordat u een nieuwe sleutel gebruikt. Ga er niet van uit dat de fout betekent dat er geen bestelling bestaat.