Dezactivați o campanie de mesagerie existentă
Utilizați această rută când retrageți din uz o campanie deținută de cont. Păstrați identificatorul campaniei pentru reconciliere și istoric. Pentru corectarea conținutului sau actualizarea textului de consimțământ, utilizați Actualizați o campanie de mesagerie în schimb.
Autentificați-vă cu un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Citiți mai întâi datele campaniei și verificați marca asociată și numerele utilizate pentru trimitere. Dezactivarea modifică înregistrarea; nu creează o campanie înlocuitoare și nu mută numerele la altă campanie.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"Eliminați mai întâi asocierile numerelor afectate
Operația publică DELETE pentru campanii nu deconectează numerele de telefon de la operatorul de mesagerie și nu elimină asocierea lor locală. Utilizați fluxul de eliminare a asocierii unui număr cu o campanie pentru fiecare număr afectat deținut de cont, apoi verificați asocierea acestuia. Eliminarea unei asocieri nu eliberează numărul de telefon.
Fluxul mai amplu «Ștergeți marca» din portal efectuează operațiile de curățare a campaniilor și numerelor acesteia înainte de a șterge marca. Nu utilizați această acțiune dacă intenționați să păstrați marca și celelalte campanii ale acesteia. Editorul obișnuit de campanii nu oferă în prezent un buton separat de ștergere a campaniei echivalent cu această rută API directă.
Trimiteți cererea de dezactivare dorită
După ce verificați identificatorul campaniei și configurația de trimitere afectată, trimiteți DELETE fără corp 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"Răspunsul de succes documentat este HTTP 204, cu un corp gol. Verificați codul de stare HTTP, fără a aștepta o structură JSON de tip status/response. La acceptarea ștergerii, serviciul actual marchează local resursa campaniei ca ștearsă și expirată și marchează înregistrarea veche a campaniei ca expirată. Ștergerea nu se propagă în cascadă la marcă.
Utilizați o singură cheie de idempotență pentru această cerere și păstrați exact metoda, calea, șirul de interogare și octeții corpului pentru retransmitere. O cerere duplicată aflată în curs de procesare poate returna 409 cu Retry-After; pentru cererile finalizate se poate returna din nou rezultatul stocat. O eroare memorată în cache sau o conexiune întreruptă nu stabilește dacă registrul a acționat deja. Păstrați identificatorul campaniei și requestId, dacă este prezent.
Verificați atât înregistrarea, cât și asocierile
După cerere, verificați în portal starea curentă a campaniei și numerele afectate. API poate păstra metadatele locale privind proprietatea după retragerea din uz, astfel încât un identificator deținut de cont să poată fi verificat în continuare; nu deduceți că același identificator trebuie să returneze întotdeauna un răspuns local 404. Registrul decide starea returnată sau disponibilitatea înregistrării retrase din uz.
Dacă un număr rămâne asociat, reconciliați asocierea existentă. Nu creați o altă campanie doar pentru a reîncerca dezactivarea și nu presupuneți că un răspuns HTTP 204 dovedește efectuarea operațiilor de curățare la operator. Dacă sincronizarea locală eșuează după ce registrul acceptă cererea, API poate returna 500 chiar dacă dezactivarea externă a avut deja loc.
| Rezultat | Pasul următor |
|---|---|
| 204 | Nu se așteaptă un corp de răspuns. Verificați starea campaniei și asocierile numerelor, gestionate independent. |
| 400 | Citiți eroarea furnizată privind validarea sau starea din registru. Verificați identificatorul exact al campaniei și starea existentă. |
| 401, 403, 404 | Verificați datele de autentificare API, adresa IP sursă permisă și dacă resursa aparține contului. Nu înlocuiți identificatorul cu cel al altui client. |
| 409, 429 | Distingeți o cerere idempotentă în curs sau aflată în conflict de limitarea ratei cererilor; respectați Retry-After atunci când este furnizat. |
| 500, 502 sau expirarea timpului de așteptare | Păstrați detaliile cererii, citiți datele campaniei existente și efectuați reconcilierea înainte de a trimite o nouă cerere. |
Retragerea din uz este separată de decontarea contului
Serviciul DELETE actual nu declanșează o debitare imediată pentru înregistrarea campaniei. Acest lucru nu garantează o rambursare, nu anulează un angajament existent și nu eliberează numerele închiriate. Verificați în portal condițiile aplicabile campaniilor contului și facturile neachitate. Închirierea numerelor și utilizarea mesajelor sunt separate de înregistrarea campaniei.
Dacă întreaga înregistrare a întreprinderii este retrasă din uz după reconcilierea campaniilor și asocierilor acesteia, continuați cu retragerea din uz a mărcii.