შეამოწმეთ ბრენდის შეფასების შედეგები

აირჩიეთ ბრენდი, რომელსაც ამოწმებთ

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

თვალი ადევნეთ არსებულ შეფასებას

შეინახეთ vettingId, evpId, vettingClass და vettingStatus მათი არსებობის შემთხვევაში. მიმდინარე სინქრონიზაცია PENDING და UNSCORE მიიჩნევს შედეგებად, რომლებიც ჯერ კიდევ დამატებით შემოწმებას ელოდება, ხოლო ACTIVE და FAILED — ანგარიშსწორებისთვის საბოლოო შედეგებად. სანამ გადაწყვეტთ, საჭიროა თუ არა შემდგომი მოქმედება, წაიკითხეთ პასუხში მიღებული დეტალები. მხოლოდ ცარიელი სია არ ადასტურებს, რომ ადრე გაგზავნილი განაცხადი რეესტრამდე არ მისულა.

გაეცანით წინა შეკვეთის საფასურს

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

გაიმეორეთ მონაცემების წაკითხვა ახალი შეკვეთის გაგზავნის გარეშე

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

რეგისტრაციის ეტაპები ცალ-ცალკე განიხილეთ

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

მოთხოვნა

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

გამოიყენეთ GET მოთხოვნა, რომლის გზაშიც ბრენდის იდენტიფიკატორია მითითებული, ხოლო მოთხოვნის პარამეტრებში — სავალდებულო vettingStatus ფილტრი. განხილული სქემა სტატუსების მასივს განსაზღვრავს; ეს მაგალითი ერთ ACTIVE მნიშვნელობას ითხოვს. ეს სახელმძღვანელო არ ადგენს რამდენიმე მნიშვნელობის კოდირების წესს და არც იმას, იღებს თუ არა პროვაიდერი გაუფილტრავ მოთხოვნას. მოთხოვნის სხეული საჭირო არ არის.

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

პასუხი

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

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

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

შეცდომები

• 401: ანგარიშის ავთენტიფიკაცია ვერ შესრულდა. შეამოწმეთ ავტორიზაციის მონაცემები, API-ის ჩართულობა და წყაროს IP მისამართზე მოქმედი შეზღუდვები.
• 404: ბრენდი ამ ანგარიშთან არ არის დაკავშირებული ან რეესტრმა ის ვერ იპოვა. ანგარიშის კუთვნილების შემოწმებით გამოწვეული უარი რეესტრში მოთხოვნის გაგზავნამდე ხდება.
• 429: მიღწეულია ანგარიშის ან რეესტრის მოთხოვნების ლიმიტი. დაიცავით Retry-After და გაზარდეთ დაყოვნება განმეორებით მცდელობებს შორის.
• 502/503: მონაცემთა გადაცემა, რეესტრი, მოთხოვნების შემზღუდველი ან ლოკალური დამუშავება მიუწვდომელია. შეცდომა არ ადასტურებს, რომ შეფასების წინა მოთხოვნა წარუმატებლად დასრულდა.

ხელმისაწვდომობა და თანმდევი ეფექტები

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