Avvikle en merkevare for meldinger

Velg fremgangsmåte for avvikling

Avvikle en merkevare for meldinger når virksomheten ikke lenger trenger registreringen. Dette avslutter bruken av den eksisterende registreringen; det registrerer ingen erstatning, frigir ikke leide telefonnumre og korrigerer ikke virksomhetens identitetsopplysninger. For å korrigere opplysninger bruker du Oppdatere en merkevare for meldinger.

Det offentlige DELETE-kallet for merkevarer og handlingen Slett merkevare i portalen har ulikt omfang. Det offentlige kallet sletter én merkevare fra registeret. Portalen samordner frakobling av numre og deaktivering av kampanjer før den forsøker å slette merkevaren.

Gjennomgå konsekvensene i portalen

Åpne siden for meldingsregistrering, finn riktig merkevare og velg Slett merkevare. Kontroller antallet tilknyttede kampanjer og tilordnede numre. Skriv inn merkevarens nøyaktige ID for å aktivere den endelige handlingen. Kundeskjemaet er bare tilgjengelig når kontoen har tillatelse til å administrere registreringer.

Portalen behandler aktive kampanjer i rekkefølge: den forsøker å koble fra hvert nummer som er tilordnet for øyeblikket, deaktiverer kampanjen og sletter deretter merkevaren. For kampanjer som allerede er merket som utløpt eller slettet, hopper den over en ny sletting i det eksterne systemet. Når disse eksterne trinnene er fullført, oppdaterer den de lokale kampanje- og nummeroppføringene i en databasetransaksjon.

Denne rekkefølgen er ikke én atomisk transaksjon på tvers av registeret, operatøren og de lokale oppføringene. En senere feil kan ikke gjenopprette et nummer eller en kampanje som allerede er endret eksternt. Ta vare på de returnerte opplysningene om frakoblede numre og deaktiverte kampanjer når de er tilgjengelige; avstem statusen for disse identifikatorene i stedet for å opprette en ny merkevare.

Forbered direkte sletting via API

Bruk en aktivert API-konto over HTTPS fra en tillatt kilde-IP-adresse. Merkevaren må tilhøre denne kontoen. Hent og ta vare på ID-en og gjeldende tilstand, og kontroller deretter kampanjene og nummertilknytningene. Koble fra de berørte numrene og deaktiver kampanjer før du sletter merkevaren. Ikke behandle dette DELETE-kallet som en kaskadeoperasjon.

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

Slett den kontrollerte merkevaren

Kjør følgende bare for den tiltenkte avviklingen, etter at du har kontrollert merkevarens ID og fullført oppryddingen ovenfor. Forespørselen har ingen JSON-kropp.

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"

Det dokumenterte resultatet ved suksess er HTTP 204 uten svarkropp. Ikke krev et JSON-objekt som bekrefter suksess, eller den eldre v3-innpakningen status/response. Et avvist resultat utenfor 2xx-serien markerer ikke merkevaren som slettet gjennom den gjeldende synkroniseringsmekanismen for API.

Bruk én idempotensnøkkel for den tiltenkte forespørselen. Behold metode, sti, spørring og byte i forespørselskroppen uendret ved gjentakelse. Nøkkelen gjør ikke den samlede oppryddingen i portalen atomisk og beviser ikke at et nummer hos operatøren er koblet fra. En duplikatforespørsel som allerede behandles, kan returnere 409 med Retry-After; fullførte forespørsler kan returnere det lagrede svaret på nytt, inkludert en feil.

Kontroller avviklingen og avstem delvise resultater

Kontroller portalens merkevare- og kampanjelister og de berørte numrene etter operasjonen. Synkroniseringen etter et vellykket kall til det offentlige API-et markerer den enkelte merkevaren som slettet lokalt; den fjerner ikke de andre kampanjeressursene eller opphever tilknytningene for kjøpte numre. Registerstatus, tilknytning hos operatøren og lokal visning må kontrolleres hver for seg.

Portalens gjeldende operatøradapter godtar et vellykket HTTP-svar uten å validere hver verdi for forretningsstatus i svarkroppen separat. Kontroller derfor de berørte numrenes faktiske kampanjetilknytninger etter opprydding i portalen, selv om portalen meldte om suksess. Hvis en tilknytning eller status ikke stemmer, må du ta vare på de berørte ID-ene og kontakte kundestøtte før du sender meldinger gjennom det avviklede oppsettet eller oppretter det på nytt.

Ved HTTP 400 leser du den detaljerte feilmeldingen fra registeret, særlig en eventuell begrensning knyttet til en aktiv kampanje. Ved 401, 403 eller 404 kontrollerer du påloggingsopplysninger, tillatt kilde-IP og at merkevaren eies av kontoen. Ved 429 følger du Retry-After. Et tidsavbrudd, 500 eller 502 kan oppstå etter at en ekstern endring er fullført; undersøk den eksisterende registreringen før du gjentar forespørselen.

Kontroller gjenstående kostnader på kontoen

Den gjeldende DELETE-tjenesten sender ikke en umiddelbar belastning for merkevareregistrering. Sletting av en merkevare frigir ikke leide telefonnumre, utløser ikke refusjon og fastsetter ikke kontoens endelige saldo. Gå gjennom eventuelle eksisterende kampanjeforpliktelser, nummerleie og brukskostnader i portalen. Denne operasjonen er ikke et pristilbud for disse separate tjenestene.