Avregistrera ett varumärke för meddelanden

Välj arbetsflöde för avregistreringen

Avregistrera ett varumärke för meddelanden när företaget inte längre behöver registreringen. Då slutar den befintliga registreringen att användas; åtgärden registrerar ingen ersättare, säger inte upp hyrda telefonnummer och rättar inte företagets identitetsuppgifter. För att rätta uppgifter använder du Uppdatera ett varumärke för meddelanden.

Det publika DELETE-anropet för varumärken och portalens åtgärd Ta bort varumärke har olika omfattning. Det publika anropet tar bort ett varumärke ur registret. Portalen samordnar bortkoppling av nummer och inaktivering av kampanjer innan den försöker ta bort varumärket.

Granska konsekvenserna i portalen

Öppna sidan för meddelanderegistrering, hitta rätt varumärke och välj Ta bort varumärke. Kontrollera antalet kopplade kampanjer och tilldelade nummer. Ange varumärkets exakta ID för att aktivera den slutliga åtgärden. Kundformuläret är endast tillgängligt när kontot har behörighet att hantera registreringar.

Portalen behandlar aktiva kampanjer i tur och ordning: den försöker koppla bort varje nummer som för närvarande är tilldelat, inaktiverar kampanjen och tar sedan bort varumärket. För kampanjer som redan är markerade som utgångna eller borttagna hoppar den över ytterligare en borttagning i det externa systemet. När dessa externa steg har lyckats uppdaterar den de lokala kampanj- och nummerposterna i en databastransaktion.

Denna sekvens är inte en enda atomär transaktion som omfattar registret, operatören och de lokala posterna. Ett senare fel kan inte återställa ett nummer eller en kampanj som redan har ändrats externt. Spara de returnerade uppgifterna om bortkopplade nummer och inaktiverade kampanjer när de finns tillgängliga; stäm av dessa identifierare i stället för att skapa ett nytt varumärke.

Förbered en direkt borttagning via API

Använd ett aktiverat API-konto via HTTPS från en tillåten käll-IP-adress. Varumärket måste tillhöra det kontot. Läs av och spara dess ID och aktuella tillstånd, och kontrollera sedan dess kampanjer och nummertilldelningar. Koppla bort berörda nummer och inaktivera kampanjer innan du tar bort varumärket. Behandla inte detta DELETE-anrop som en kaskadåtgärd.

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

Ta bort det granskade varumärket

Kör följande endast för den avsedda avregistreringen, efter att du har kontrollerat varumärkets ID och slutfört den föregående rensningen. Begäran 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 dokumenterade resultatet vid framgång är HTTP 204 utan svarskropp. Kräv inte ett JSON-objekt som anger framgång eller det äldre v3-formatets status/response-omslag. Ett avvisat resultat utanför 2xx-serien markerar inte varumärket som borttaget via den nuvarande synkroniseringsvägen för API.

Använd en idempotensnyckel för den avsedda begäran. Behåll metod, sökväg, frågesträng och kroppens byte oförändrade när begäran upprepas. Nyckeln gör inte portalens mer omfattande rensning atomär och bevisar inte att ett nummer hos operatören har kopplats bort. En dubblett av en pågående begäran kan returnera 409 med Retry-After; slutförda begäranden kan återge sitt sparade svar, även ett felsvar.

Verifiera avregistreringen och stäm av delresultaten

Kontrollera portalens varumärkes- och kampanjlistor samt de berörda numren efter åtgärden. Det publika API:ets synkronisering vid framgång markerar det enskilda varumärket som borttaget lokalt; den tar inte bort övriga kampanjresurser och rensar inte tilldelningar för köpta nummer. Registerstatus, tilldelning hos operatören och den lokala visningen måste kontrolleras separat.

Portalens nuvarande operatörsadapter accepterar ett HTTP-svar som anger framgång utan att separat validera varje verksamhetsstatusvärde i svarskroppen. Kontrollera därför de berörda numrens faktiska kampanjtilldelningar efter en rensning via portalen, även om portalen rapporterade att åtgärden lyckades. Om en tilldelning eller status är inkonsekvent ska du spara berörda ID:n och kontakta supporten innan du skickar meddelanden genom eller återskapar den avregistrerade konfigurationen.

Vid HTTP 400 ska du läsa det detaljerade registerfelet, särskilt en eventuell begränsning på grund av en aktiv kampanj. Vid 401, 403 eller 404 ska du kontrollera autentiseringsuppgifterna, tillåten käll-IP-adress och att varumärket tillhör kontot. Vid 429 ska du följa Retry-After. En timeout, 500 eller 502 kan inträffa efter att en extern ändring har slutförts; granska den befintliga registreringen innan du upprepar begäran.

Kontrollera kontots återstående avgifter

Den nuvarande DELETE-tjänsten utlöser ingen omedelbar debitering för varumärkesregistrering. Att ta bort ett varumärke säger inte upp de hyrda telefonnumren, ger ingen återbetalning och fastställer inte kontots slutliga saldo. Granska eventuella befintliga kampanjåtaganden samt avgifter för nummerhyra och användning i portalen. Denna åtgärd utgör ingen offert för dessa separata tjänster.