Scegli la procedura di dismissione
Dismetti un marchio per la messaggistica quando l'azienda non ha più bisogno di quella registrazione. Questa operazione interrompe l'utilizzo della registrazione esistente; non registra un marchio sostitutivo, non rilascia i numeri di telefono a noleggio e non corregge i dati identificativi dell'azienda. Per una correzione, usa Aggiornare un marchio per la messaggistica.
La chiamata pubblica DELETE per il marchio e l'azione Elimina marchio del portale hanno ambiti diversi. La chiamata pubblica elimina un singolo marchio dal registro. Il portale coordina la dissociazione dei numeri e la disattivazione delle campagne prima di tentare l'eliminazione del marchio.
| Procedura | Cosa fa |
|---|---|
| Portale: Elimina marchio | Mostra le campagne associate e i numeri assegnati, richiede l'identificativo del marchio come conferma, quindi tenta di rimuovere le relative associazioni prima di eliminare il marchio. Se un passaggio successivo non riesce, i passaggi precedenti possono restare completati. |
| API: DELETE /tcr/v2/brand/{brandId} | Richiede esclusivamente l'eliminazione di questo marchio di proprietà dell'account. Non dissocia automaticamente i numeri e non disattiva le campagne del marchio. Una campagna attiva può impedire l'eliminazione. |
Esamina l'impatto nel portale
Apri la pagina di registrazione per la messaggistica, individua il marchio corretto e scegli Elimina marchio. Controlla il numero di campagne associate e di numeri assegnati. Digita l'identificativo esatto del marchio per abilitare l'azione finale. Il modulo per il cliente è disponibile solo se l'account dispone dell'autorizzazione per la gestione delle registrazioni.
Il portale elabora le campagne attive in sequenza: tenta di dissociare ciascun numero attualmente assegnato, disattiva la campagna e infine elimina il marchio. Non esegue un'ulteriore eliminazione remota per le campagne già contrassegnate come scadute o eliminate. Dopo il completamento di questi passaggi esterni, aggiorna i record locali delle campagne e dei numeri all'interno di una transazione del database.
Questa sequenza non costituisce un'unica transazione atomica tra il registro, l'operatore e i record locali. Un errore successivo non può ripristinare un numero o una campagna già modificati esternamente. Conserva i dettagli restituiti sui numeri dissociati e sulle campagne disattivate, quando disponibili; verifica e riallinea gli stati corrispondenti a quegli identificativi anziché creare un altro marchio.
Prepara un'eliminazione diretta tramite API
Usa un account API abilitato tramite HTTPS da un indirizzo IP di origine consentito. Il marchio deve appartenere a quell'account. Leggi e conserva il suo identificativo e lo stato attuale, quindi controlla le campagne e le assegnazioni dei numeri. Dissocia i numeri interessati e disattiva le campagne prima di eliminare il marchio. Non considerare questa chiamata DELETE un'operazione a cascata.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Elimina il marchio verificato
Esegui quanto segue solo per la dismissione prevista, dopo aver verificato l'identificativo del marchio e completato la rimozione delle associazioni descritta in precedenza. La richiesta non prevede un corpo JSON.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request DELETE \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Il risultato positivo documentato è HTTP 204 senza corpo della risposta. Non richiedere un oggetto di esito positivo in formato JSON né il precedente contenitore v3 status/response. Un risultato di rifiuto con codice non-2xx non contrassegna il marchio come eliminato tramite l'attuale percorso di sincronizzazione dell'API.
Usa una sola chiave di idempotenza per la richiesta prevista. In caso di ripetizione, mantieni invariati il metodo, il percorso, la stringa di query e i byte del corpo. La chiave non rende atomica la più ampia procedura di rimozione delle associazioni del portale e non dimostra che un numero sia stato dissociato presso l'operatore. Una richiesta duplicata mentre l'originale è ancora in corso può restituire 409 con Retry-After; le richieste completate possono restituire nuovamente la risposta salvata, incluso un errore.
Verifica la dismissione e riallinea i risultati parziali
Dopo l'operazione, controlla gli elenchi dei marchi e delle campagne nel portale e i numeri interessati. La sincronizzazione in caso di esito positivo dell'API pubblica contrassegna il singolo marchio come eliminato localmente; non rimuove le altre risorse delle campagne e non cancella le assegnazioni dei numeri acquistati. Lo stato nel registro, l'assegnazione presso l'operatore e la visualizzazione locale richiedono verifiche separate.
L'attuale adattatore del portale per l'operatore accetta una risposta HTTP di esito positivo senza convalidare separatamente ogni valore di stato applicativo presente nel corpo. Per questo motivo, dopo la rimozione delle associazioni tramite il portale, verifica le effettive assegnazioni alle campagne dei numeri interessati, anche se il portale ha segnalato un esito positivo. Se un'assegnazione o uno stato non è coerente, conserva gli identificativi interessati e contatta l'assistenza prima di inviare messaggi tramite la configurazione dismessa o di ricrearla.
Per HTTP 400, leggi l'errore dettagliato del registro, in particolare eventuali restrizioni dovute a campagne attive. Per 401, 403 o 404, verifica le credenziali, l'indirizzo IP di origine consentito e la proprietà del marchio da parte dell'account. Per 429, rispetta Retry-After. Un timeout, un errore 500 o un errore 502 possono verificarsi dopo una modifica esterna già completata; esamina la registrazione esistente prima di ripetere la richiesta.
Controlla gli addebiti residui dell'account
L'attuale servizio DELETE non avvia un addebito immediato per la registrazione del marchio. L'eliminazione di un marchio non rilascia i numeri di telefono a noleggio, non emette un rimborso e non determina il saldo finale dell'account. Controlla nel portale eventuali impegni contrattuali esistenti per le campagne, i canoni di noleggio dei numeri e gli addebiti per l'utilizzo. Questa operazione non costituisce un preventivo per tali servizi separati.