Consulta i risultati della verifica di un marchio

Seleziona il marchio di cui vuoi verificare i risultati

Usa l'identificativo del marchio presente nel tuo account. Conservalo insieme ai record di verifica ottenuti, per evitare di confondere la verifica di un'impresa con quella di un'altra. Non usare identificativi di un altro account.

Segui una verifica già avviata

Conserva vettingId, evpId, vettingClass e vettingStatus quando presenti. La sincronizzazione attuale considera PENDING e UNSCORE come risultati ancora in attesa di ulteriori controlli, e ACTIVE e FAILED come risultati definitivi ai fini del saldo degli addebiti. Leggi i dettagli restituiti prima di decidere se sono necessarie altre azioni. Un elenco vuoto, da solo, non dimostra che un invio precedente non sia arrivato al registro.

Comprendi gli addebiti relativi a un ordine precedente

La consultazione dello stato non ordina un'altra verifica. Può tuttavia riconciliare un risultato definitivo e saldare l'addebito associato a una precedente richiesta di verifica a pagamento. Ciò include l'eventuale addebito previsto in caso di esito negativo. Fai riferimento al prezzo e alle condizioni esaminati al momento dell'ordine; non dedurre il prezzo attuale da un vecchio esempio o da una risposta sullo stato.

Riprova la lettura senza inviare un altro ordine

In caso di errore temporaneo, conserva l'identificativo del marchio e gli identificativi di verifica noti, rispetta Retry-After e riprova questa lettura aumentando progressivamente gli intervalli tra i tentativi. Non inviare un nuovo ordine di verifica soltanto perché la consultazione dello stato non è riuscita o ha restituito un corpo inatteso. Se la discrepanza persiste, contatta MultiTEL tramite un canale di assistenza autenticato, fornendo i relativi identificativi di riferimento.

Mantieni separate le fasi di registrazione

La verifica determina un esito di valutazione per il marchio. La qualificazione della campagna, la registrazione della campagna e l'assegnazione dei numeri restano fasi separate. Controllane lo stato attuale e i requisiti prima di inviare messaggi.

Richiesta

Usa un account API abilitato tramite HTTPS, da un indirizzo IP di origine consentito. Usa le credenziali del tuo account, non quelle del registro. Il marchio deve essere associato all'account autenticato.

Esegui una richiesta GET con l'identificativo del marchio nel percorso e il filtro di query obbligatorio vettingStatus. Lo schema esaminato definisce un array di stati; questo esempio richiede un solo valore ACTIVE. Questa guida non conferma né la codifica di più valori né l'accettazione da parte del fornitore di richieste senza filtro. Non è richiesto un corpo della richiesta.

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

Parametri del percorso
Nome	Tipo	Obbligatorio	Descrizione
`brandId`	stringa	Sì	L'identificativo del marchio nel registro associato al tuo account MultiTEL. Non è l'identificativo del tuo account né un identificativo di verifica.

Parametri di query
Nome	Tipo	Obbligatorio	Descrizione
`vettingStatus`	array di stringhe	Sì	Filtro di stato obbligatorio. Valori consentiti: PENDING, UNSCORE, ACTIVE, FAILED, EXPIRED. L'esempio fornisce un solo valore ACTIVE; non si afferma che siano supportate la codifica di più valori o l'accettazione da parte del fornitore di richieste senza filtro.

Risposta

La rotta attuale conserva lo stato HTTP e il corpo della risposta del registro anziché usare l'involucro di risposta della precedente versione v3. L'array fittizio abbreviato illustra i campi utilizzati dal percorso di sincronizzazione locale; non è una risposta acquisita dal registro né uno schema di cui sia garantita la completezza. Controlla lo stato HTTP e il contenuto JSON prima di leggere i record. Conserva ogni vettingId insieme al marchio selezionato.

Struttura della risposta a scopo illustrativo; non rappresenta dati reali dell'account né un preventivo attuale.

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

Errori

401: Autenticazione dell'account non riuscita. Controlla le credenziali, l'abilitazione dell'API e le restrizioni applicabili all'IP di origine.
404: Il marchio non è associato a questo account oppure il registro non è riuscito a trovarlo. Un rifiuto dovuto alla mancata titolarità del marchio da parte dell'account avviene prima della richiesta al registro.
429: Raggiunto il limite di richieste dell'account o del registro. Rispetta Retry-After e aumenta progressivamente gli intervalli tra i tentativi.
502/503: Il trasporto, il registro, il limitatore delle richieste o l'elaborazione locale non è disponibile. Un errore non dimostra che una richiesta di verifica precedente non sia andata a buon fine.

Disponibilità ed effetti collaterali

Questa richiesta GET non inoltra un nuovo ordine di verifica. Recupera i risultati dal registro, scrive i record di controllo delle richieste e sincronizza i risultati memorizzati.
La lettura di un risultato definitivo può saldare l'addebito per un ordine di verifica a pagamento inoltrato in precedenza. Una verifica con esito negativo può comportare il relativo addebito, se previsto. Esamina il prezzo e le condizioni al momento dell'ordine; questa lettura non costituisce un preventivo.
Un record appena individuato e importato da questa richiesta GET non viene classificato automaticamente come un nuovo ordine a pagamento.
Un risultato di verifica positivo o con stato ACTIVE non costituisce approvazione della campagna, assegnazione di un numero telefonico o autorizzazione a inviare messaggi.