Consulter les résultats de vérification d’une marque

Sélectionnez la marque à vérifier

Utilisez l’identifiant de marque de votre compte. Conservez-le avec les enregistrements de vérification obtenus pour éviter de confondre la vérification d’une entreprise avec celle d’une autre. N’utilisez pas les identifiants d’un autre compte.

Suivez une vérification existante

Conservez les champs vettingId, evpId, vettingClass et vettingStatus lorsqu’ils sont présents. La synchronisation actuelle considère PENDING et UNSCORE comme des résultats nécessitant encore des contrôles, et ACTIVE et FAILED comme des résultats définitifs pour le règlement des frais. Lisez les détails renvoyés avant de décider si un suivi est nécessaire. Une liste vide ne prouve pas, à elle seule, qu’un envoi précédent n’est pas parvenu au registre.

Comprenez les frais d’une commande antérieure

La consultation du statut ne commande pas de nouvelle vérification. Elle peut toutefois rapprocher un résultat définitif des données enregistrées et régler les frais associés à une demande de vérification facturable antérieure. Cela inclut les éventuels frais applicables en cas d’échec. Reportez-vous au prix et aux conditions examinés lors de la commande ; ne déduisez pas le prix actuel d’un ancien exemple ou d’une réponse de statut.

Réessayez la consultation sans passer une autre commande

En cas d’échec temporaire, conservez l’identifiant de marque et les identifiants de vérification connus, respectez Retry-After et réessayez cette consultation en espaçant progressivement les tentatives. Ne passez pas une nouvelle commande de vérification simplement parce que la consultation du statut a échoué ou a renvoyé un corps de réponse inattendu. Si une incohérence persiste, contactez MultiTEL en fournissant les identifiants de référence concernés via un canal d’assistance authentifié.

Distinguez les étapes d’enregistrement

La vérification établit un résultat d’examen pour la marque. La qualification de la campagne, son enregistrement et l’attribution des numéros restent des étapes distinctes. Vérifiez leur statut actuel et leurs exigences avant d’envoyer des messages.

Requête

Utilisez un compte API activé via HTTPS, depuis une adresse IP source autorisée. Utilisez les identifiants d’authentification de votre compte, et non ceux du registre. La marque doit être associée au compte authentifié.

Effectuez une requête GET avec l’identifiant de marque dans le chemin et le filtre de requête obligatoire vettingStatus. Le schéma examiné définit un tableau de statuts ; cet exemple demande une seule valeur ACTIVE. Ce guide ne confirme ni l’encodage de plusieurs valeurs ni l’acceptation de requêtes sans filtre par le fournisseur. Aucun corps de requête n’est requis.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"

Paramètres de chemin
Nom	Type	Obligatoire	Description
`brandId`	chaîne de caractères	Oui	L’identifiant de marque du registre associé à votre compte MultiTEL. Il ne s’agit ni de l’identifiant de votre compte ni d’un identifiant de vérification.

Paramètres de requête
Nom	Type	Obligatoire	Description
`vettingStatus`	tableau de chaînes de caractères	Oui	Filtre de statut obligatoire. Valeurs autorisées : PENDING, UNSCORE, ACTIVE, FAILED, EXPIRED. L’exemple fournit une seule valeur ACTIVE ; il n’affirme ni l’encodage de plusieurs valeurs ni l’acceptation de requêtes sans filtre par le fournisseur.

Réponse

La route actuelle conserve le statut HTTP et le corps de réponse du registre au lieu d’utiliser l’ancienne enveloppe de réponse v3. Le tableau fictif abrégé illustre les champs utilisés par le processus de synchronisation local ; il ne s’agit ni d’une réponse capturée du registre ni d’un schéma dont l’exhaustivité est garantie. Vérifiez le statut HTTP et le contenu JSON avant de lire les enregistrements. Conservez chaque vettingId avec la marque sélectionnée.

Structure de réponse fournie à titre d’exemple ; il ne s’agit ni de données réelles de compte ni d’un devis actuel.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Erreurs

401: Échec de l’authentification du compte. Vérifiez les identifiants d’authentification, l’activation de l’API et les restrictions applicables à l’adresse IP source.
404: La marque n’est pas associée à ce compte, ou le registre ne l’a pas trouvée. Tout refus lié à l’appartenance de la marque au compte intervient avant la requête au registre.
429: La limite de requêtes du compte ou du registre est atteinte. Respectez Retry-After et espacez progressivement les tentatives.
502/503: Le transport, le registre, le limiteur de requêtes ou le traitement local est indisponible. Une erreur ne prouve pas qu’une demande de vérification antérieure a échoué.

Disponibilité et effets de bord

Cette requête GET ne passe pas de nouvelle commande de vérification. Elle récupère les résultats du registre, écrit des enregistrements d’audit des requêtes et synchronise les résultats stockés.
La consultation d’un résultat définitif peut régler les frais d’une commande de vérification facturable passée auparavant. Une vérification échouée peut entraîner les frais applicables en cas d’échec. Examinez le prix et les conditions lors de la commande ; cette consultation ne constitue pas un devis.
Un enregistrement nouvellement découvert et importé par cette requête GET n’est pas automatiquement classé comme une nouvelle commande facturable.
Un résultat de vérification réussi ou ACTIVE ne constitue ni une approbation de campagne, ni une attribution de numéro de téléphone, ni une autorisation d’envoyer des messages.