დეველოპერებისთვის

PUT/tcr/v2/brand/{brandId}/revet

შეტყობინებების გამგზავნი ბრენდის ხელახალი ვერიფიკაცია

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

ამ გვერდზე
  1. ხელახლა შეამოწმეთ ბიზნესის შესწორებული საიდენტიფიკაციო მონაცემები
  2. გაგზავნამდე გადახედეთ ბრენდს
  3. დაადასტურეთ ცალკე საფასური
  4. გაგზავნეთ ერთი განზრახული მცდელობა
  5. გაეცანით შედეგს და თვალი ადევნეთ მის სტატუსს
  6. გაარკვიეთ გაურკვეველი შედეგი
  7. მომხმარებლის პორტალის გამოყენება

ხელახლა შეამოწმეთ ბიზნესის შესწორებული საიდენტიფიკაციო მონაცემები

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

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

გაგზავნამდე გადახედეთ ბრენდს

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

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

დაადასტურეთ ცალკე საფასური

საწარმოო გარემოში ხელახალი ვერიფიკაციის ამჟამად დაყენებული საფასურია US$5.00 თითოეულ მიღებულ მცდელობაზე, გადამოწმებულია 24 ოქტომბერს, 2026 წელს. გამოიყენება ბრენდის სტანდარტული საფასური, მათ შორის მაშინაც, როცა თავდაპირველ სუბიექტს რეგისტრაციის განსხვავებული ფასი აქვს. შესყიდვები ჩართული უნდა იყოს; წინასწარი გადახდის ანგარიშებს გაგზავნამდე საკმარისი ნაშთი უნდა ჰქონდეს.

202 პასუხი ნიშნავს, რომ მოთხოვნა მიღებულია შემდგომი დამუშავებისთვის და საფასურის დარიცხვა მიღებისთანავე იგზავნება დასამუშავებლად. ეს არ ნიშნავს, რომ ბიზნესი ვერიფიცირებულია. მოგვიანებით ახალ მცდელობას შეიძლება კიდევ ერთი საფასური მოჰყვეს. ახალ მცდელობას მხოლოდ იმიტომ ნუ შექმნით, რომ ვერიფიკაცია ჯერ კიდევ მოლოდინის რეჟიმშია.

გაგზავნეთ ერთი განზრახული მცდელობა

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

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

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

გაეცანით შედეგს და თვალი ადევნეთ მის სტატუსს

ხელახალი ვერიფიკაციის პასუხები
პასუხიმნიშვნელობა და შემდეგი მოქმედება
200მოთხოვნა წარმატებით შესრულდა. შეამოწმეთ პასუხში დაბრუნებული ბრენდი და ხელახლა წაიკითხეთ ბრენდის მიმდინარე ჩანაწერი ვინაობის შემოწმების სტატუსის დასადასტურებლად.
202მიღებულია, შემდგომი ვერიფიკაციის მოლოდინშია. შეინახეთ ბრენდის იდენტიფიკატორი და მოგვიანებით შეამოწმეთ მისი მიმდინარე სტატუსი სხვა ფასიანი მცდელობის გაგზავნის გარეშე.
400გადახედეთ რეესტრიდან დაბრუნებულ შეცდომებს. შესაძლოა თავდაპირველი რეგისტრაცია ჯერ განხილვის პროცესში იყოს, პროფილი უცვლელი იყოს ან ვალიდაციის სხვა წესი მოქმედებდეს.
401 / 404შეამოწმეთ ავტორიზაციის მონაცემები და ნებადართული IP მისამართი, ან ანგარიშის კუთვნილი ბრენდის იდენტიფიკატორი.
402 / 503გადახედეთ შესყიდვის/თანხის შევსების ან ფასის/სერვისის ლოკალურ შეცდომას. ნუ ჩათვლით, რომ ყოველი 503 ადასტურებს, თითქოს ზედა დონის სერვისში მოთხოვნა არ გაგზავნილა.
429დაიცავით Retry-After სათაურში მითითებული ლოდინის დრო და მცდელობის მონაცემები უცვლელად შეინარჩუნეთ.

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

გაარკვიეთ გაურკვეველი შედეგი

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

მომხმარებლის პორტალის გამოყენება

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

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