Деактивирајте кампању за размену порука

Деактивирајте постојећу кампању за размену порука

Користите ову руту када гасите кампању у власништву налога. Сачувајте идентификатор кампање ради усаглашавања и историје. За исправке садржаја или ажурирање текста сагласности користите Ажурирајте кампању за размену порука уместо тога.

Аутентификујте се помоћу омогућеног API налога преко HTTPS са дозвољене изворне IP адресе. Најпре учитајте кампању и проверите повезани бренд и бројеве за слање. Деактивација мења регистрацију; не прави заменску кампању нити премешта бројеве у другу кампању.

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

Најпре уклоните доделе обухваћених бројева

Јавна операција DELETE за кампању не одваја телефонске бројеве од оператера за размену порука нити уклања њихову локалну доделу. Користите поступак уклањања доделе броја кампањи за сваки обухваћени број у власништву налога, а затим проверите његову доделу. Уклањање доделе не ослобађа телефонски број.

Шири поступак „Избриши бренд” у порталу обавља чишћење кампања и бројева тог бренда пре него што га избрише. Не користите ту радњу ако намеравате да задржите бренд и његове остале кампање. Тренутни стандардни уређивач кампања нема засебно дугме за брисање кампање које одговара овој директној API рути.

Пошаљите захтев за намеравану деактивацију

Након што проверите идентификатор кампање и обухваћена подешавања слања, пошаљите DELETE без 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"

Документовани успешан одговор је HTTP 204 са празним телом. Проверите HTTP статус уместо да очекујете JSON омотач status/response. Када је брисање прихваћено, тренутни сервис локално означава ресурс кампање као избрисан и истекао, а њен запис у старом систему као истекао. Брисање се не преноси каскадно на бренд.

Користите један кључ идемпотентности за овај намеравани захтев и сачувајте потпуно исти метод, путању, упит и бајтове тела за поновно слање. Дупликат захтева који се још обрађује може вратити 409 са Retry-After; за завршене захтеве може се поново вратити сачувани резултат. Кеширана грешка или прекинута веза не потврђује да ли је регистар већ поступио по захтеву. Сачувајте идентификатор кампање и requestId када је присутан.

Проверите и регистрацију и доделе

После захтева проверите тренутно стање кампање и обухваћене бројеве у порталу. API може задржати локалне метаподатке о власништву након гашења, па се идентификатор у власништву налога и даље може проверити; немојте закључити да исти идентификатор увек мора да врати локални 404. Регистар одређује враћени статус или доступност угашеног записа.

Ако број остане додељен, усагласите ту постојећу доделу. Не правите другу кампању само да бисте поново покушали деактивацију и не претпостављајте да HTTP 204 доказује да је чишћење код оператера обављено. Ако локална синхронизација не успе након што регистар прихвати захтев, API може вратити 500 иако је спољна деактивација већ извршена.

Гашење је одвојено од измирења обавеза по налогу

Тренутни сервис DELETE не покреће непосредно задужење за регистрацију кампање. То не гарантује повраћај новца, не поништава постојећу обавезу нити ослобађа изнајмљене бројеве. У порталу проверите услове за кампање који важе за налог и неплаћене фактуре. Закуп бројева и потрошња за поруке одвојени су од регистрације кампање.

Ако гасите целокупну регистрацију предузећа након што су његове кампање и доделе усаглашене, наставите са гашењем бренда.