Çaktivizoni një fushatë mesazhesh

Çaktivizoni një fushatë ekzistuese mesazhesh

Përdoreni këtë rrugë kur hiqni nga përdorimi një fushatë në pronësi të llogarisë. Ruajeni identifikuesin e fushatës për rakordim dhe historik. Për korrigjime të përmbajtjes ose përditësime të tekstit të pëlqimit, përdorni Përditësoni një fushatë mesazhesh në vend të kësaj.

Autentikohuni me një llogari API të aktivizuar, përmes HTTPS, nga një adresë IP burimore e lejuar. Lexoni fillimisht të dhënat e fushatës dhe kontrolloni markën e lidhur me të dhe numrat e përdorur për dërgim. Çaktivizimi ndryshon regjistrimin; ai nuk krijon një fushatë zëvendësuese dhe nuk i zhvendos numrat te një fushatë tjetër.

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

Hiqni fillimisht caktimet e numrave të prekur

Operacioni publik DELETE për fushatat nuk i shkëput numrat e telefonit nga operatori i mesazheve dhe nuk e heq caktimin e tyre lokal. Përdorni rrjedhën e punës për heqjen e lidhjes së një numri me një fushatë për çdo numër të prekur në pronësi të llogarisë, pastaj verifikoni caktimin e tij. Heqja e një caktimi nuk e liron numrin e telefonit.

Rrjedha më e gjerë e punës «Fshi markën» në portal kryen pastrimin e fushatave dhe numrave të saj përpara se ta fshijë atë markë. Mos e përdorni këtë veprim kur synoni të mbani markën dhe fushatat e tjera të saj. Redaktuesi i zakonshëm aktual i fushatave nuk ofron një buton të veçantë për fshirjen e fushatës, të barasvlershëm me këtë rrugë të drejtpërdrejtë API.

Dërgoni kërkesën për çaktivizimin e synuar

Pasi të shqyrtoni identifikuesin e fushatës dhe konfigurimin e prekur të dërgimit, dërgoni DELETE pa trup 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/campaign/$CAMPAIGN_ID"

Përgjigjja e suksesshme e dokumentuar është HTTP 204 me trup bosh. Kontrolloni kodin e statusit HTTP në vend që të prisni një strukturë JSON të tipit status/response. Kur fshirja pranohet, shërbimi aktual e shënon lokalisht burimin e fushatës si të fshirë dhe të skaduar, si dhe e shënon regjistrimin e saj në sistemin e vjetër si të skaduar. Fshirja nuk përhapet në kaskadë te marka.

Përdorni një çelës të vetëm idempotence për këtë kërkesë të synuar dhe ruani saktësisht metodën, shtegun, vargun e parametrave të kërkimit dhe bajtet e trupit për ridërgim. Një kërkesë e dyfishtë që është në përpunim mund të kthejë 409 me Retry-After; për kërkesat e përfunduara mund të kthehet sërish rezultati i ruajtur. Një gabim i ruajtur në memorien e përkohshme ose një lidhje e ndërprerë nuk përcakton nëse regjistri ka vepruar tashmë. Ruani identifikuesin e fushatës dhe requestId, kur është i pranishëm.

Verifikoni si regjistrimin, ashtu edhe caktimet

Pas kërkesës, kontrolloni në portal gjendjen aktuale të fushatës dhe numrat e prekur. API mund t’i ruajë metadatat lokale të pronësisë pas heqjes nga përdorimi, në mënyrë që një identifikues në pronësi të llogarisë të mund të kontrollohet ende; mos nxirrni përfundimin se i njëjti identifikues duhet të kthejë gjithmonë një përgjigje lokale 404. Regjistri vendos statusin që kthehet ose disponueshmërinë e regjistrimit të hequr nga përdorimi.

Nëse një numër mbetet i caktuar, rakordoni atë caktim ekzistues. Mos krijoni një fushatë tjetër thjesht për të riprovuar çaktivizimin dhe mos supozoni se një përgjigje HTTP 204 provon se pastrimi te operatori është kryer. Nëse sinkronizimi lokal dështon pasi regjistri e pranon kërkesën, API mund të kthejë 500 edhe pse çaktivizimi i jashtëm ka ndodhur tashmë.

Rezultatet e çaktivizimit
Rezultati	Hapi tjetër
204	Nuk pritet trup përgjigjeje. Verifikoni gjendjen e fushatës dhe caktimet e numrave, të cilat menaxhohen në mënyrë të pavarur.
400	Lexoni gabimin e dhënë të validimit ose të gjendjes në regjistër. Kontrolloni identifikuesin e saktë të fushatës dhe gjendjen ekzistuese.
401, 403, 404	Kontrolloni kredencialet API, adresën IP burimore të lejuar dhe nëse burimi i përket llogarisë. Mos e zëvendësoni identifikuesin me atë të një klienti tjetër.
409, 429	Dalloni një kërkesë idempotente në proces ose në konflikt nga kufizimi i shpeshtësisë së kërkesave; respektoni Retry-After kur jepet.
500, 502 ose skadim i kohës së pritjes	Ruani hollësitë e kërkesës, lexoni të dhënat e fushatës ekzistuese dhe kryeni rakordimin përpara se të dërgoni një kërkesë tjetër.

Heqja nga përdorimi është e veçantë nga shlyerja e llogarisë

Shërbimi aktual DELETE nuk nis një debitim të menjëhershëm për regjistrimin e fushatës. Kjo nuk premton rimbursim, nuk shuan një detyrim ekzistues dhe nuk i liron numrat e marrë me qira. Kontrolloni në portal kushtet e fushatave të llogarisë dhe faturat e papaguara. Qiraja e numrave dhe përdorimi i mesazheve janë të veçanta nga regjistrimi i fushatës.

Nëse i gjithë regjistrimi i biznesit po hiqet nga përdorimi pasi janë rakorduar fushatat dhe caktimet e tij, vazhdoni me heqjen e markës nga përdorimi.