Деактивирайте кампания за съобщения

Деактивирайте съществуваща кампания за съобщения

Използвайте този маршрут, когато прекратявате кампания, притежавана от акаунта. Запазете идентификатора на кампанията за съгласуване и справки в историята. За корекции на съдържанието или актуализации на текста за съгласие използвайте Актуализирайте кампания за съобщения вместо това.

Удостоверете се с активиран 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, въпреки че външното деактивиране вече е извършено.

Резултати от деактивирането
Резултат	Следваща стъпка
204	Не се очаква тяло на отговора. Проверете състоянието на кампанията и свързванията на номерата, които се управляват независимо.
400	Прочетете предоставената грешка при валидирането или за състоянието в регистъра. Проверете точния идентификатор на кампанията и съществуващото състояние.
401, 403, 404	Проверете идентификационните данни за API, разрешения изходен IP адрес и собствеността на акаунта. Не заменяйте идентификатора с такъв на друг клиент.
409, 429	Разграничете идемпотентна заявка в процес на изпълнение или в конфликт от ограничаване на честотата на заявките; спазвайте Retry-After, когато е предоставен.
500, 502 или изтичане на времето за изчакване	Запазете подробностите за заявката, извлечете съществуващата кампания и съгласувайте състоянието, преди да изпратите нова заявка.

Прекратяването е отделно от уреждането на задълженията по акаунта

Текущата услуга DELETE не задейства незабавно начисляване на такса за регистрация на кампания. Това не гарантира възстановяване на сума, не отменя съществуващ ангажимент и не освобождава наети номера. Проверете в портала условията за кампаниите на акаунта и неплатените фактури. Наемът на номера и потреблението на съобщения са отделни от регистрацията на кампания.

Ако прекратявате цялата регистрация на фирмата, след като кампаниите и свързванията ѝ са съгласувани, продължете с прекратяване на регистрацията на марката.