Tag et beskedbrand ud af brug

Vælg fremgangsmåde til at tage brandet ud af brug

Tag et beskedbrand ud af brug, når virksomheden ikke længere har brug for registreringen. Dermed ophører brugen af den eksisterende registrering; det registrerer ikke en erstatning, frigiver ikke lejede telefonnumre og retter ikke virksomhedens identitetsoplysninger. Brug følgende til rettelser: Opdatér et beskedbrand.

Det offentlige DELETE-kald for brands og portalens handling Slet brand har forskelligt omfang. Det offentlige kald sletter ét brand i registret. Portalen koordinerer fjernelse af nummertilknytninger og deaktivering af kampagner, før den forsøger at slette brandet.

Gennemgå konsekvenserne i portalen

Åbn siden til beskedregistrering, find det korrekte brand, og vælg Slet brand. Gennemgå antallet af tilknyttede kampagner og tildelte numre. Indtast brandets nøjagtige ID for at aktivere den endelige handling. Kundeformularen er kun tilgængelig, når kontoen har tilladelse til at administrere registreringer.

Portalen behandler aktive kampagner i rækkefølge: den forsøger at fjerne tilknytningen for hvert aktuelt tildelt nummer, deaktiverer kampagnen og sletter derefter brandet. Den springer endnu en fjernsletning over for kampagner, der allerede er markeret som udløbet eller slettet. Når disse eksterne trin er lykkedes, opdaterer den de lokale kampagne- og nummerposter i en databasetransaktion.

Denne rækkefølge er ikke én atomar transaktion på tværs af registret, teleoperatøren og de lokale poster. En senere fejl kan ikke gendanne et nummer eller en kampagne, der allerede er ændret eksternt. Gem de returnerede oplysninger om numre med fjernet tilknytning og deaktiverede kampagner, når de er tilgængelige; afstem disse identifikatorer i stedet for at oprette endnu et brand.

Forbered en direkte sletning via API

Brug en aktiveret API-konto over HTTPS fra en tilladt kilde-IP-adresse. Brandet skal tilhøre denne konto. Hent og gem dets ID og aktuelle tilstand, og kontrollér derefter dets kampagner og nummertilknytninger. Fjern tilknytningen for de berørte numre, og deaktivér kampagner før du sletter brandet. Betragt ikke dette DELETE-kald som en kaskadeoperation.

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

Slet det gennemgåede brand

Udfør kun følgende for det brand, der skal tages ud af brug, efter at have kontrolleret brandets ID og gennemført den foregående oprydning. Anmodningen har ingen JSON-brødtekst.

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 dokumenterede resultat ved succes er HTTP 204 uden svarbrødtekst. Kræv ikke et JSON-objekt, der angiver succes, eller den ældre v3-indpakning med status/response. Et afvist resultat uden for 2xx markerer ikke brandet som slettet via den nuværende synkroniseringsmekanisme for API.

Brug én idempotensnøgle til den påtænkte anmodning. Bevar metode, sti, forespørgsel og brødtekstens bytes uændret ved gentagelse. Nøglen gør ikke portalens samlede oprydning atomar og beviser ikke, at et nummers tilknytning er fjernet hos teleoperatøren. En dublet af en igangværende anmodning kan returnere 409 med Retry-After; afsluttede anmodninger kan returnere deres gemte svar igen, også hvis det er en fejl.

Kontrollér, at brandet er taget ud af brug, og afstem delvise resultater

Kontrollér portalens brand- og kampagnelister samt de berørte numre efter handlingen. Synkroniseringen efter et vellykket kald til det offentlige API markerer det enkelte brand som slettet lokalt; den fjerner ikke de øvrige kampagneressourcer og rydder ikke tilknytninger for købte numre. Status i registret, tilknytning hos teleoperatøren og den lokale visning skal kontrolleres hver for sig.

Portalens nuværende teleoperatøradapter accepterer et HTTP-svar, der angiver succes, uden særskilt at validere hver værdi for forretningsstatus i svarbrødteksten. Kontrollér derfor de berørte numres faktiske kampagnetilknytninger efter en oprydning i portalen, selv hvis portalen meldte om succes. Hvis en tilknytning eller status ikke stemmer, skal du gemme de berørte ID'er og kontakte support, før du sender via eller genopretter den opsætning, der er taget ud af brug.

Ved HTTP 400 skal du læse den detaljerede fejl fra registret, især en begrænsning på grund af en aktiv kampagne. Ved 401, 403 eller 404 skal du kontrollere legitimationsoplysninger, tilladt kilde-IP og kontoejerskab. Ved 429 skal du overholde Retry-After. En timeout, 500 eller 502 kan forekomme efter en gennemført ekstern ændring; undersøg den eksisterende registrering, før du gentager anmodningen.

Kontrollér de resterende opkrævninger på kontoen

Den nuværende DELETE-tjeneste udløser ikke en øjeblikkelig debitering for brandregistrering. Sletning af et brand frigiver ikke de lejede telefonnumre, medfører ikke en tilbagebetaling og fastlægger ikke kontoens endelige saldo. Gennemgå eventuelle eksisterende kampagneforpligtelser, nummerleje og forbrugsafgifter i portalen. Denne handling er ikke et pristilbud på disse separate tjenester.