Utilisez une marque de messagerie appartenant au compte
Utilisez un compte API activé via HTTPS, depuis une adresse IP source autorisée. Les authentifications Basic et Bearer sont prises en charge. L’identifiant de marque doit appartenir à ce compte. Gardez confidentiels les jetons du prestataire, les données d’identité de la marque et les rapports renvoyés.
Commandez une nouvelle vérification externe
Utilisez POST lorsque vous souhaitez qu’un prestataire effectue une nouvelle vérification de cette marque. Si vous disposez déjà d’un résultat du prestataire, utilisez plutôt l’importation. Cette opération est distincte de la nouvelle vérification de l’identité de la marque.
Consultez d’abord la marque actuelle et confirmez ses informations d’identité. Sélectionnez un prestataire et une classe pris en charge dans les catalogues actuels et vérifiez les exigences de ce prestataire. Tous les prestataires ne prennent pas en charge toutes les classes. Les informations supplémentaires de vérification politique doivent décrire l’organisation ou la campagne réelle, et non contenir des données d’exemple.
Préparez la demande destinée au prestataire
| Champ | Valeur |
|---|---|
| evpId | Identifiant obligatoire du prestataire, issu du catalogue actuel des prestataires de vérification externe, de 1–10 caractères. |
| vettingClass | La classe prise en charge que vous souhaitez acheter ; choisissez-la explicitement et confirmez son prix. |
| additionalRequestPayload | Une chaîne encodée en JSON contenant les informations propres au prestataire, obligatoire pour la vérification politique. Il s’agit d’une chaîne dans l’objet JSON externe, et non d’un objet imbriqué. Confirmez toutes les informations requises auprès du prestataire sélectionné. |
Confirmez les frais en cas de réussite et d’échec
Tarifs de détail actuels en dollars américains, consultés le 24 octobre 2026. Confirmez le montant en vigueur avant de passer une commande réelle. Le solde prépayé est vérifié par rapport au prix en cas de réussite ; les achats doivent être activés.
| Classe | Résultat actif | Résultat en échec |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL avec demande Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Les commandes en attente conservent leurs montants de réussite et d’échec et sont réglées lorsqu’un résultat ACTIVE ou FAILED est synchronisé. Les deux dernières classes appliquent les mêmes frais configurés pour les deux résultats définitifs possibles. Un résultat immédiatement définitif peut être facturé lors de la réponse à la commande. Une synchronisation ultérieure du statut peut régler des frais en attente.
Ne considérez pas mock:true comme une garantie de gratuité de la vérification externe. Le processus actuel de règlement des vérifications externes peut tout de même enregistrer et facturer cette commande. Ces instructions n’exigent aucun achat réel pour les tests ; utilisez des jeux de données de test hors ligne tant que vous ne souhaitez pas autoriser une vérification payante.
Envoyez une seule commande après l’avoir vérifiée
Préparez vetting-order.json avec l’identifiant du prestataire, la classe et toutes les informations supplémentaires requises. Ce fichier contient la demande réelle que vous souhaitez envoyer. Gardez-le confidentiel.
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"Suivez le résultat réel
Une réponse HTTP réussie peut contenir un enregistrement de vérification en attente. Conservez son vettingId et examinez vettingStatus, les motifs, le score et les dates de prise d’effet et d’expiration, selon leur disponibilité. PENDING et UNSCORE nécessitent un suivi supplémentaire ; ACTIVE, FAILED et EXPIRED correspondent à des résultats différents. L’acceptation HTTP à elle seule ne prouve ni un score favorable ni l’admissibilité d’une campagne.
Utilisez le statut de la vérification externe pour suivre l’enregistrement. La consultation ou l’importation d’un résultat définitif peut régler une commande payante antérieure ; cette opération n’exclut pas nécessairement la perception de frais existants encore dus.
Réessayez la même demande prévue
Utilisez une seule Idempotency-Key par opération prévue et conservez exactement la méthode, le chemin, la chaîne de requête et les octets du corps. Les clés acceptent 1–128 caractères ASCII imprimables, sans espaces. Un doublon d’une demande en cours peut renvoyer 409 avec Retry-After. Les demandes terminées renvoient leur réponse enregistrée, y compris les erreurs. Respectez les limites de débit.
Une réponse 502 mise en cache peut faire suite à un échec de transport. Une réponse 500 mise en cache avec requestId peut signifier que le registre a accepté l’opération, mais que l’enregistrement local ou la facturation a échoué. Conservez l’identifiant de la demande, examinez les enregistrements actuels et clarifiez la situation avec l’assistance avant d’utiliser une nouvelle clé. Ne supposez pas que l’erreur signifie qu’aucune commande n’existe.