Usa un marchio di messaggistica appartenente all’account
Usa un account API abilitato tramite HTTPS da un indirizzo IP di origine consentito. Sono supportate le autenticazioni Basic e Bearer. L’ID del marchio deve appartenere a tale account. Mantieni riservati i token del fornitore, i dati identificativi del marchio e i rapporti restituiti.
Ordina una nuova verifica esterna
Usa POST quando è necessario che un fornitore di verifiche esegua una nuova verifica per questo marchio. Se disponi già di un risultato del fornitore, usa l’importazione in alternativa. Questa operazione è distinta dalla nuova verifica dell’identità del marchio.
Consulta prima i dati attuali del marchio e confermane le informazioni identificative. Seleziona una combinazione di fornitore e classe supportata dai cataloghi attuali e controlla i requisiti del fornitore. Non tutti i fornitori supportano tutte le classi. I dettagli aggiuntivi per la verifica politica devono descrivere l’organizzazione o la campagna effettiva e non devono essere dati di esempio.
Prepara la richiesta per il fornitore
| Campo | Valore |
|---|---|
| evpId | ID obbligatorio del fornitore, tratto dal catalogo attuale dei fornitori di verifiche esterne, di 1–10 caratteri. |
| vettingClass | La classe supportata che intendi acquistare; selezionala esplicitamente e confermane il prezzo. |
| additionalRequestPayload | Una stringa codificata in JSON contenente dettagli specifici del fornitore, obbligatoria per la verifica politica. È una stringa all’interno dell’oggetto JSON esterno, non un oggetto annidato. Conferma tutti i dettagli richiesti con il fornitore selezionato. |
Conferma gli addebiti in caso di esito positivo e negativo
Tariffe al dettaglio attuali in dollari statunitensi, consultate il 24 ottobre 2026. Conferma l’importo attuale prima di effettuare un ordine reale. La disponibilità prepagata viene verificata rispetto al prezzo per l’esito positivo; gli acquisti devono essere abilitati.
| Classe | Esito attivo | Esito negativo |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL con richiesta Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Gli ordini in sospeso mantengono gli importi previsti per l’esito positivo e negativo e vengono liquidati quando viene sincronizzato un risultato ACTIVE o FAILED. Le ultime due classi applicano la stessa tariffa configurata per entrambi gli esiti definitivi. Un esito definitivo immediato può essere addebitato durante la risposta all’ordine. Una successiva sincronizzazione dello stato può liquidare un addebito in sospeso.
Non considerare mock:true una garanzia di verifica esterna gratuita. L’attuale procedura di liquidazione delle verifiche esterne può comunque registrare e addebitare tale ordine. Queste istruzioni non richiedono un acquisto reale per i test; usa dati di prova offline finché non intendi autorizzare una verifica a pagamento.
Invia un solo ordine dopo averlo controllato
Prepara vetting-order.json con l’ID del fornitore, la classe e tutte le informazioni aggiuntive richieste. Il file contiene la richiesta effettiva che intendi inviare. Mantienilo riservato.
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"Segui l’esito effettivo
Una risposta HTTP riuscita può contenere una registrazione di verifica in sospeso. Conservane il valore vettingId e controlla vettingStatus, le motivazioni, il punteggio e le date di decorrenza e scadenza, se disponibili. PENDING e UNSCORE richiedono ulteriori controlli; ACTIVE, FAILED e EXPIRED descrivono esiti diversi. La sola accettazione HTTP non dimostra un punteggio favorevole né l’idoneità della campagna.
Usa lo stato della verifica esterna per seguire la registrazione. La lettura o l’importazione di un esito definitivo può liquidare un precedente ordine a pagamento; non è necessariamente esente da un addebito già in sospeso.
Riprova la stessa richiesta prevista
Usa un valore Idempotency-Key per ogni operazione prevista e conserva esattamente il metodo, il percorso, la query e i byte del corpo. Le chiavi supportano 1–128 caratteri ASCII stampabili senza spazi. Un duplicato di una richiesta in corso può restituire 409 con Retry-After. Per le richieste completate viene riproposta la risposta memorizzata, inclusi gli errori. Rispetta i limiti di frequenza delle richieste.
Una risposta 502 memorizzata nella cache può derivare da un errore di trasporto. Una risposta 500 memorizzata nella cache con requestId può indicare che il registro ha accettato l’operazione, ma che il salvataggio locale o la fatturazione non sono riusciti. Conserva l’ID della richiesta, controlla le registrazioni attuali e chiarisci la situazione con l’assistenza prima di usare una nuova chiave. Non presumere che l’errore significhi che non esiste alcun ordine.