შეტყობინებების ბრენდის გამოყენებიდან ამოღება

აირჩიეთ გამოყენებიდან ამოღების პროცესი

შეტყობინებების ბრენდი გამოყენებიდან ამოიღეთ მაშინ, როცა ბიზნესს ეს რეგისტრაცია აღარ სჭირდება. ამით არსებული რეგისტრაციის გამოყენება წყდება; ეს არ არეგისტრირებს მის შემცვლელს, არ ათავისუფლებს იჯარით აღებულ ტელეფონის ნომრებს და არ ასწორებს ბიზნესის საიდენტიფიკაციო მონაცემებს. შესწორებისთვის გამოიყენეთ შეტყობინებების ბრენდის განახლება.

ბრენდის საჯარო DELETE გამოძახებასა და პორტალის მოქმედებას „ბრენდის წაშლა“ განსხვავებული მოქმედების არეალი აქვს. საჯარო გამოძახება რეესტრიდან ერთ ბრენდს შლის. ბრენდის წაშლის მცდელობამდე პორტალი კოორდინაციას უწევს ნომრების მოხსნასა და კამპანიების დეაქტივაციას.

გაეცანით შედეგებს პორტალში

გახსენით შეტყობინებების რეგისტრაციის გვერდი, იპოვეთ სწორი ბრენდი და აირჩიეთ „ბრენდის წაშლა“. შეამოწმეთ დაკავშირებული კამპანიებისა და მინიჭებული ნომრების რაოდენობა. საბოლოო მოქმედების გასააქტიურებლად ზუსტად შეიყვანეთ ბრენდის იდენტიფიკატორი. მომხმარებლის ფორმა ხელმისაწვდომია მხოლოდ მაშინ, როცა ანგარიშს რეგისტრაციების მართვის ნებართვა აქვს.

პორტალი აქტიურ კამპანიებს თანმიმდევრულად ამუშავებს: ცდილობს თითოეული ამჟამად მინიჭებული ნომრის მოხსნას, ახდენს კამპანიის დეაქტივაციას და შემდეგ შლის ბრენდს. იმ კამპანიებისთვის, რომლებიც უკვე ვადაგასულად ან წაშლილად არის მონიშნული, ის დისტანციურ წაშლას ხელახლა აღარ ასრულებს. ამ გარე ნაბიჯების წარმატებით დასრულების შემდეგ მონაცემთა ბაზის ტრანზაქციის ფარგლებში აახლებს კამპანიებისა და ნომრების ადგილობრივ ჩანაწერებს.

ეს თანმიმდევრობა რეესტრის, ოპერატორისა და ადგილობრივი ჩანაწერების მომცველი ერთი ატომური ტრანზაქცია არ არის. მოგვიანებით წარმოქმნილი შეცდომა ვერ აღადგენს გარე სისტემაში უკვე შეცვლილ ნომერს ან კამპანიას. თუ ხელმისაწვდომია, შეინახეთ პასუხში დაბრუნებული მოხსნილი ნომრებისა და დეაქტივირებული კამპანიების დეტალები; სხვა ბრენდის შექმნის ნაცვლად, ამ იდენტიფიკატორების მიხედვით შეაჯერეთ მდგომარეობა.

მოემზადეთ API-ით პირდაპირი წაშლისთვის

გამოიყენეთ ჩართული API ანგარიში HTTPS-ით, ნებადართული წყაროს IP მისამართიდან. ბრენდი ამ ანგარიშს უნდა ეკუთვნოდეს. წაიკითხეთ და შეინახეთ მისი იდენტიფიკატორი და მიმდინარე მდგომარეობა, შემდეგ კი შეამოწმეთ მისი კამპანიები და ნომრების მინიჭებები. მოხსენით შესაბამისი ნომრების მინიჭებები და მოახდინეთ კამპანიების დეაქტივაცია ბრენდის წაშლამდე. ეს DELETE კასკადურ ოპერაციად არ მიიჩნიოთ.

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

წაშალეთ შემოწმებული ბრენდი

ქვემოთ მოცემული ბრძანება შეასრულეთ მხოლოდ განზრახული გამოყენებიდან ამოღებისთვის, ბრენდის იდენტიფიკატორის შემოწმებისა და ზემოთ აღწერილი გასუფთავების დასრულების შემდეგ. მოთხოვნას 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/brand/$BRAND_ID"

დოკუმენტაციით განსაზღვრული წარმატებული შედეგია HTTP 204, პასუხის სხეულის გარეშე. ნუ მოითხოვთ წარმატების JSON ობიექტს ან მოძველებულ v3 status/response გარსს. უარყოფილი, 2xx დიაპაზონის გარეთ მყოფი შედეგი მიმდინარე API სინქრონიზაციის მექანიზმით ბრენდს წაშლილად არ მონიშნავს.

განზრახული მოთხოვნისთვის გამოიყენეთ ერთი იდემპოტენტურობის გასაღები. განმეორებითი გაგზავნისას უცვლელად დატოვეთ მეთოდი, გზა, მოთხოვნის პარამეტრები და სხეულის ბაიტები. ეს გასაღები პორტალის მთლიან გასუფთავებას ატომურს არ ხდის და არ ადასტურებს, რომ ოპერატორის ნომრის მინიჭება მოიხსნა. ჯერ კიდევ დამუშავების პროცესში მყოფი მოთხოვნის დუბლიკატმა შეიძლება დააბრუნოს 409 და Retry-After; დასრულებულმა მოთხოვნებმა შეიძლება ხელახლა დააბრუნოს შენახული პასუხი, მათ შორის შეცდომაც.

გადაამოწმეთ გამოყენებიდან ამოღება და შეაჯერეთ ნაწილობრივი შედეგები

ოპერაციის შემდეგ შეამოწმეთ პორტალში ბრენდებისა და კამპანიების სიები და შესაბამისი ნომრები. საჯარო API-ის წარმატებული შედეგის სინქრონიზაცია ცალკეულ ბრენდს ადგილობრივად წაშლილად მონიშნავს; ის არ შლის სხვა კამპანიების რესურსებს და არ ასუფთავებს შეძენილი ნომრების მინიჭებებს. რეესტრის სტატუსი, ოპერატორთან მინიჭება და ადგილობრივი ჩვენება ცალ-ცალკე უნდა შემოწმდეს.

პორტალში ოპერატორთან კავშირის მიმდინარე ადაპტერი იღებს HTTP წარმატების პასუხს ისე, რომ მის სხეულში ბიზნესსტატუსის თითოეულ მნიშვნელობას ცალკე არ ამოწმებს. ამიტომ პორტალით გასუფთავების შემდეგ გადაამოწმეთ, რეალურად რომელ კამპანიებზეა მინიჭებული შესაბამისი ნომრები, მაშინაც კი, თუ პორტალმა წარმატება აჩვენა. თუ მინიჭება ან სტატუსი შეუსაბამოა, შეინახეთ შესაბამისი იდენტიფიკატორები და დაუკავშირდით მხარდაჭერას, სანამ გამოყენებიდან ამოღებული კონფიგურაციით გაგზავნას ან მის ხელახლა შექმნას დაიწყებთ.

HTTP 400-ის შემთხვევაში წაიკითხეთ რეესტრის შეცდომის დეტალები, განსაკუთრებით აქტიურ კამპანიასთან დაკავშირებული შეზღუდვა. 401, 403 ან 404-ის შემთხვევაში შეამოწმეთ ავტორიზაციის მონაცემები, წყაროს ნებადართული IP მისამართი და ანგარიშის კუთვნილება. 429-ის შემთხვევაში დაიცავით Retry-After-ით მითითებული ლოდინის დრო. დროის ლიმიტის ამოწურვა, 500 ან 502 შეიძლება გარე სისტემაში ცვლილების დასრულების შემდეგაც მოხდეს; მოთხოვნის გამეორებამდე შეამოწმეთ არსებული რეგისტრაცია.

შეამოწმეთ ანგარიშზე დარჩენილი გადასახადები

მიმდინარე DELETE სერვისი ბრენდის რეგისტრაციის საფასურის დაუყოვნებლივ ჩამოჭრის ოპერაციას არ აგზავნის. ბრენდის წაშლა არ ათავისუფლებს იჯარით აღებულ ტელეფონის ნომრებს, არ აბრუნებს თანხას და არ განსაზღვრავს ანგარიშის საბოლოო ნაშთს. პორტალში გაეცანით კამპანიებთან დაკავშირებულ არსებულ ვალდებულებებს, ნომრების იჯარისა და გამოყენების გადასახადებს. ეს ოპერაცია ამ ცალკეული მომსახურებების ფასის შეთავაზებას არ წარმოადგენს.