Valitse käytöstä poistamisen työnkulku
Poista viestintäbrändi käytöstä, kun yritys ei enää tarvitse kyseistä rekisteröintiä. Tämä lopettaa nykyisen rekisteröinnin käytön; se ei rekisteröi korvaavaa brändiä, vapauta vuokrattuja puhelinnumeroita eikä korjaa yrityksen tunnistetietoja. Korjaa tiedot toiminnolla Päivitä viestintäbrändi.
Julkisen brändin DELETE-kutsun ja portaalin Poista brändi -toiminnon laajuudet eroavat toisistaan. Julkinen kutsu poistaa yhden brändin rekisteristä. Portaali koordinoi numeroiden irrottamisen ja kampanjoiden deaktivoinnin ennen kuin se yrittää poistaa brändin.
| Työnkulku | Toiminta |
|---|---|
| Portaali: Poista brändi | Näyttää liittyvät kampanjat ja kohdistetut numerot, vaatii vahvistukseksi brändin tunnisteen ja yrittää sitten tehdä niihin liittyvän siivouksen ennen brändin poistamista. Aiemmat vaiheet voivat jäädä suoritetuiksi, jos myöhempi vaihe epäonnistuu. |
| API: DELETE /tcr/v2/brand/{brandId} | Pyytää vain tämän tilin omistaman brändin poistamista. Se ei automaattisesti irrota numeroita eikä deaktivoi brändin kampanjoita. Aktiivinen kampanja voi estää poistamisen. |
Tarkista vaikutukset portaalissa
Avaa viestinnän rekisteröintisivu, etsi oikea brändi ja valitse Poista brändi. Tarkista liittyvien kampanjoiden ja kohdistettujen numeroiden määrät. Kirjoita brändin tunniste täsmälleen oikein, jotta lopullinen toiminto tulee käyttöön. Asiakaslomake on käytettävissä vain, jos tilillä on rekisteröintien hallintaoikeus.
Portaali käsittelee aktiiviset kampanjat järjestyksessä: se yrittää irrottaa jokaisen sillä hetkellä kohdistetun numeron, deaktivoi kampanjan ja poistaa sitten brändin. Se ohittaa uuden poiston etäjärjestelmässä niiden kampanjoiden osalta, jotka on jo merkitty vanhentuneiksi tai poistetuiksi. Kun nämä ulkoiset vaiheet onnistuvat, se päivittää paikalliset kampanja- ja numerotietueet tietokantatransaktiossa.
Tämä vaiheketju ei ole yksi atominen transaktio, joka kattaisi rekisterin, operaattorin ja paikalliset tietueet. Myöhempi virhe ei voi palauttaa numeroa tai kampanjaa, jota on jo muutettu ulkoisessa järjestelmässä. Säilytä palautetut tiedot irrotetuista numeroista ja deaktivoiduista kampanjoista, kun ne ovat saatavilla; täsmäytä näiden tunnisteiden tiedot sen sijaan, että loisit uuden brändin.
Valmistele suora poisto API:n kautta
Käytä käyttöön otettua API-tiliä HTTPS-yhteydellä sallitusta lähde-IP-osoitteesta. Brändin on kuuluttava kyseiselle tilille. Lue ja tallenna sen tunniste ja nykyinen tila ja tarkista sitten sen kampanjat ja numeroiden kohdistukset. Irrota asiaankuuluvat numerot ja deaktivoi kampanjat ennen brändin poistamista. Älä käsittele tätä DELETE-kutsua ketjutettuna poistotoimintona.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Poista tarkistettu brändi
Suorita seuraava vain aiottua käytöstä poistamista varten, kun olet tarkistanut brändin tunnisteen ja tehnyt edellä kuvatun siivouksen. Pyynnössä ei ole JSON-runkoa.
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"Dokumentoitu onnistunut tulos on HTTP 204 ilman vastausrunkoa. Älä edellytä onnistumista ilmaisevaa JSON-objektia äläkä vanhan v3-version status/response-käärettä. Hylätty tulos, joka ei kuulu 2xx-sarjaan, ei merkitse brändiä poistetuksi nykyisen API-synkronointipolun kautta.
Käytä yhtä idempotenssiavainta aiotulle pyynnölle. Säilytä metodi, polku, kysely ja rungon tavut muuttumattomina, kun toistat pyynnön. Avain ei tee portaalin laajemmasta siivouksesta atomista eikä todista, että operaattorin numero olisi irrotettu. Keskeneräisen pyynnön kaksoiskappale voi palauttaa koodin 409 ja Retry-After-otsakkeen; valmiiden pyyntöjen tallennettu vastaus voidaan palauttaa uudelleen, myös silloin kun se on virhe.
Varmista käytöstä poistaminen ja täsmäytä osittaiset tulokset
Tarkista toiminnon jälkeen portaalin brändi- ja kampanjaluettelot sekä asiaankuuluvat numerot. Julkisen API:n onnistumisen synkronointi merkitsee yksittäisen brändin poistetuksi paikallisesti; se ei poista muita kampanjaresursseja eikä tyhjennä ostettujen numeroiden kohdistuksia. Rekisterin tila, operaattorin kohdistus ja paikallinen näkymä on tarkistettava erikseen.
Portaalin nykyinen operaattorisovitin hyväksyy onnistumista ilmaisevan HTTP-vastauksen tarkistamatta erikseen jokaista sen rungossa olevaa liiketoimintatilan arvoa. Tarkista siksi asiaankuuluvien numeroiden todelliset kampanjakohdistukset portaalissa tehdyn siivouksen jälkeen, vaikka portaali ilmoittaisi onnistumisesta. Jos kohdistuksessa tai tilassa on ristiriita, säilytä asiaankuuluvat tunnisteet ja ota yhteyttä tukeen ennen kuin lähetät viestejä käytöstä poistetun määrityksen kautta tai luot määrityksen uudelleen.
Kun tulos on HTTP 400, lue rekisterin yksityiskohtainen virheilmoitus ja huomioi erityisesti aktiiviseen kampanjaan liittyvä rajoitus. Koodeilla 401, 403 tai 404 tarkista tunnistetiedot, sallittu lähde-IP-osoite ja se, että brändi kuuluu tilille. Koodilla 429 noudata Retry-After-otsaketta. Aikakatkaisu, 500 tai 502 voi ilmetä jo valmistuneen ulkoisen muutoksen jälkeen; tarkista nykyinen rekisteröinti ennen pyynnön toistamista.
Tarkista tilin jäljellä olevat maksut
Nykyinen DELETE-palvelu ei käynnistä välitöntä brändin rekisteröintiveloitusta. Brändin poistaminen ei vapauta vuokrattuja puhelinnumeroita, tuota hyvitystä eikä määritä tilin lopullista saldoa. Tarkista portaalissa mahdolliset nykyiset kampanjasitoumukset sekä numeroiden vuokra- ja käyttömaksut. Tämä toiminto ei ole hintatarjous näistä erillisistä palveluista.