Verificare nuovamente l'identità aziendale corretta
Usa questa operazione quando occorre verificare nuovamente i dati identificativi corretti di un marchio già esistente di un'organizzazione. Per prima cosa, aggiorna il marchio esistente, quindi consulta lo stato attuale della sua identità. Un normale aggiornamento del profilo non invia questo tentativo separato a pagamento. La nuova verifica non crea un altro marchio né registra una campagna.
Usa il tuo account API abilitato tramite HTTPS da un indirizzo IP di origine consentito. Il marchio deve appartenere a tale account. Mantieni riservati i record dei marchi: contengono informazioni aziendali e di contatto.
Esaminare il marchio prima dell'invio
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonControlla che il marchio restituito corrisponda all'azienda desiderata e che la correzione sia presente. Non è ancora possibile ripetere la verifica se la registrazione originale è in sospeso. Il registro può rifiutare una richiesta se le informazioni aziendali sono invariate. L'assenza di attributi speciali può richiedere un ricorso anziché un'altra verifica dell'identità. I marchi delle imprese individuali utilizzano l'apposita procedura di identità/PIN; non considerare questo endpoint un suo sostituto.
Confermare l'addebito separato
La tariffa attualmente configurata per la nuova verifica nell'ambiente di produzione è di US$5.00 per tentativo accettato, verificata il 24 ottobre 2026. Si applica la tariffa standard per i marchi, anche quando l'entità originale ha un prezzo di registrazione diverso. Gli acquisti devono essere abilitati; gli account prepagati devono disporre di un saldo sufficiente prima dell'invio.
Una risposta 202 indica che la richiesta è stata accettata per un'ulteriore elaborazione e che l'addebito viene avviato al momento dell'accettazione. Non significa che l'azienda sia verificata. Un nuovo tentativo successivo può comportare un altro addebito. Non creare un nuovo tentativo solo perché la verifica è ancora in sospeso.
Inviare un singolo tentativo intenzionale
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"Non è richiesto un corpo della richiesta contenente il profilo: vengono verificati i dati del marchio già memorizzati. Usa una chiave di idempotenza univoca per il tentativo desiderato e mantieni esattamente invariati metodo, percorso, query e corpo della richiesta quando riprovi. Le chiavi supportano 1–128 caratteri ASCII stampabili senza spazi. Una richiesta duplicata mentre il tentativo è in corso può restituire 409 con Retry-After; un tentativo completato può riproporre il risultato salvato, compreso un errore.
L'API pubblica accetta anche l'autenticazione Bearer per un account con token abilitato. Restano applicabili i controlli di appartenenza all'account e dell'indirizzo IP di origine consentito. I marchi simulati memorizzati non seguono questa procedura di addebito prevista per la produzione, ma un risultato nell'ambiente di prova non costituisce una verifica dell'identità nell'ambiente di produzione.
Leggere il risultato e seguirne lo stato
| Risposta | Significato e azione successiva |
|---|---|
| 200 | La richiesta è riuscita. Esamina il marchio restituito e rileggi il record attuale del marchio per confermare lo stato dell'identità. |
| 202 | Richiesta accettata, in attesa di ulteriori verifiche. Conserva l'identificativo del marchio e controllane lo stato attuale in un secondo momento, senza inviare un altro tentativo a pagamento. |
| 400 | Esamina gli errori restituiti dal registro. La registrazione originale potrebbe essere in sospeso, il profilo potrebbe essere invariato oppure potrebbe applicarsi un'altra regola di convalida. |
| 401 / 404 | Controlla le credenziali e l'indirizzo IP consentito, oppure l'identificativo del marchio appartenente all'account. |
| 402 / 503 | Esamina l'errore locale relativo ad acquisti o disponibilità di fondi, oppure a prezzi o servizio. Non presumere che ogni risposta 503 dimostri che non sia stata effettuata alcuna richiesta al servizio a monte. |
| 429 | Rispetta Retry-After e mantieni invariati i dettagli del tentativo. |
Il proxy aggiorna il proprio record locale del marchio dopo l'accettazione di una modifica; tale aggiornamento non dimostra di per sé un esito definitivo della verifica. Un'azienda può rimanere non verificata o in attesa. Prima di proseguire con la configurazione della campagna, fai riferimento allo stato attuale del marchio anziché alla sola accettazione HTTP.
Chiarire un esito incerto
Un errore di trasporto può produrre una risposta 502 memorizzata nella cache. Una richiesta accettata dal servizio a monte, seguita da un errore locale di salvataggio persistente o di fatturazione, può produrre una risposta 500 memorizzata nella cache con requestId. Conserva tale identificativo e, con l'assistenza, verifica e riconcilia lo stato attuale del marchio e della fatturazione. Generare un'altra chiave può creare un tentativo fatturabile separatamente; non riprovare alla cieca con una nuova chiave.
Utilizzare il portale clienti
Il portale offre la nuova verifica per un'organizzazione nell'ambiente di produzione con stato UNVERIFIED, dopo l'esame del profilo attuale e dell'addebito. Controlla che il profilo e il prezzo non siano cambiati e rifiuta un ulteriore invio accettato per gli stessi dati attuali. I marchi dell'ambiente di prova e quelli delle imprese individuali sono esclusi da questa azione del portale.
Queste misure di tutela del portale sono controlli aggiuntivi della procedura. I client che accedono direttamente all'API devono effettuare una propria verifica e non devono presumere che l'API richieda i campi del portale relativi alla versione o alla conferma del prezzo. Il salvataggio di una normale correzione del marchio è un'azione separata e non invia automaticamente una richiesta di nuova verifica.