აირჩიეთ თქვენს ანგარიშზე არსებული ბრენდი
დაიწყეთ რეესტრში არსებული ბრენდის იდენტიფიკატორით, რომელიც უკვე დაკავშირებულია თქვენს MultiTEL ანგარიშთან. ეს ძიება არც ბრენდს ქმნის და არც სხვის ბრენდს აკავშირებს თქვენს ანგარიშთან. მომხმარებლის მიმდინარე სამუშაო პროცესი შესაბამისობის მონაცემების მოთხოვნამდე ამოწმებს მფლობელობას. თუ ძიება აბრუნებს 404-ს, გადაამოწმეთ არჩეული ანგარიში და ბრენდი; მის ნაცვლად ადგილობრივი ჩანაწერის იდენტიფიკატორი არ გამოიყენოთ.
ამ შედეგის მიხედვით შეადგინეთ გამოყენების შემთხვევების არჩევანი
გამოყენების შემთხვევების საერთო კატალოგი აღწერს რეესტრის ვარიანტებს. კონკრეტული ბრენდის ეს ძიება არჩეული ბრენდისთვის ხელმისაწვდომ არჩევანს იძლევა. შეინარჩუნეთ დაბრუნებული თითოეული usecase მნიშვნელობა და შეუთავსეთ მას კატალოგში არსებული საჩვენებელი დასახელება და აღწერა. საერთო კატალოგის ყველა ჩანაწერს ნუ შესთავაზებთ ისე, თითქოს ბრენდი თითოეულის მოთხოვნებს აკმაყოფილებდეს.
პორტალი მოელის, რომ ეს პასუხი იქნება JSON სია. თუ პასუხი არ არის, არასწორი ფორმატისაა ან შეცდომას წარმოადგენს, შეინარჩუნეთ მომხმარებლის ფორმა და აჩვენეთ, რომ შესაბამისობის მონაცემები ვერ ჩაიტვირთა. ეს მომხმარებლისთვის შეტყობინების გარეშე ნაგულისხმევი გამოყენების შემთხვევის დამტკიცებად არ მიიჩნიოთ. რეესტრმა შეიძლება შემოკლებულ მაგალითში ნაჩვენების გარდა სხვა ველებიც დააბრუნოს.
ჩატვირთეთ არჩეული გამოყენების შემთხვევის მოთხოვნები
მას შემდეგ, რაც მომხმარებელი დაბრუნებული გამოყენების შემთხვევის მნიშვნელობას აირჩევს, მოითხოვეთ /tcr/v2/campaignBuilder/brand/{brand_id}/usecase/{usecase} იმავე ბრენდისთვის. ეს პასუხი შეიცავს გამოყენების ქვეკატეგორიების ზღვრულ პირობებსა და ოპერატორებისთვის სპეციფიკურ მოთხოვნებს. გამოიყენეთ იგი შეტყობინებების ნიმუშების, თანხმობისა და სხვა სავალდებულო განცხადებების შესაგროვებლად. მხოლოდ შესაბამისობის სია კამპანიის სრული სარეგისტრაციო განაცხადის შესადგენად საკმარისი არ არის.
ანგარიშის ფასები ცალკე განიხილეთ
პროვაიდერის ისეთი ველები, როგორიცაა monthlyFee, quarterlyFee ან annualFee, დაბრუნების შემთხვევაში აღწერს პროვაიდერის საფასურის მეტამონაცემებს. ისინი არ ანაცვლებს მომხმარებლის ანგარიშის ფასს ან რეგისტრაციის პირობებს. მიმდინარე პორტალი კამპანიების საცალო ფასებს ცალკე კითხულობს და განხილვის ეკრანისთვის შესაბამისობის მონაცემებს უთავსებს. მომხმარებლის გადასახდელი თანხა არ განსაზღვროთ ჩამონათვლის ტიპის ძველ დამხმარე ფუნქციაში კოდით ფიქსირებული ფასებიდან.
განაახლეთ მონაცემები ბრენდის ან გამოყენების შემთხვევის შეცვლისას
ბრენდის შეცვლისას გააუქმეთ წინა ბრენდის არჩევანის ვარიანტები და ახალი არჩევანისთვის ჩატვირთეთ შესაბამისობის მონაცემები. გაგზავნამდე განაახლეთ არჩეული გამოყენების შემთხვევის მოთხოვნები. ეს GET მოთხოვნები არ აგზავნის სარეგისტრაციო განაცხადს, არ ააქტიურებს კამპანიას და არ ანიჭებს ნომრებს.
მოთხოვნა
გამოიყენეთ ჩართული API ანგარიში HTTPS-ით, ნებადართული წყაროს IP მისამართიდან. მიმდინარე მარშრუტი მხარს უჭერს ანგარიშის ავთენტიფიკაციის პოლიტიკას, მათ შორის Basic ავთენტიფიკაციას და მატარებელი ტოკენით ავთენტიფიკაციისთვის ჩართულ API ანგარიშებს. პროვაიდერის ავტორიზაციის მონაცემები არ გამოიყენოთ.
GET მოთხოვნა ბრენდის იდენტიფიკატორით URL-ის გზაში. მოთხოვნის სხეული საჭირო არ არის.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/campaignBuilder/brand/$BRAND_ID"| სახელი | ტიპი | სავალდებულო | აღწერა |
|---|---|---|---|
brand_id | სტრიქონი | დიახ | რეესტრის ბრენდის იდენტიფიკატორი, რომელიც დაკავშირებულია თქვენს ავთენტიფიცირებულ MultiTEL ანგარიშთან. გამოიყენეთ ბრენდის იდენტიფიკატორი და არა ადგილობრივი მონაცემთა ბაზის ჩანაწერის იდენტიფიკატორი, კამპანიის იდენტიფიკატორი ან ბიზნესის საგადასახადო ნომერი. დააკოდირეთ იგი URL-ის გზის ერთ სეგმენტად. |
პასუხი
მიმდინარე TCR მარშრუტი პირდაპირ აბრუნებს რეესტრის JSON სხეულს და ინარჩუნებს მის HTTP სტატუსს. იგი არ ამატებს ძველი v3 ვერსიის status/response გარსს. შემოკლებული გამოგონილი მაგალითი შესაბამისობის რეალურ შედეგს არ წარმოადგენს. გამოყენებამდე შეამოწმეთ HTTP სტატუსი და მოსალოდნელი JSON სტრუქტურა. მიმდინარე პორტალი მოელის შესაბამისობის ჩანაწერების სიას, სადაც თითოეული ჩანაწერი განსაზღვრავს usecase მნიშვნელობას. საჩვენებელი დასახელებებისთვის იგი ამ ჩანაწერებს usecase კატალოგს უთავსებს, ხოლო საცალო ფასებს ცალკე კითხულობს. შესაძლოა პროვაიდერის დამატებითი ველებიც იყოს წარმოდგენილი.
პასუხის სტრუქტურის საილუსტრაციო მაგალითი; არ წარმოადგენს ანგარიშის რეალურ მონაცემებს ან მიმდინარე საფასო შეთავაზებას.
[
{
"usecase": "2FA"
}
]შეცდომები
- 401: ანგარიშის ავთენტიფიკაცია ვერ შესრულდა. შეამოწმეთ API ავტორიზაციის მონაცემები, ანგარიშის ჩართული მდგომარეობა და წყაროს IP მისამართზე მოქმედი შეზღუდვები.
- 404: ბრენდი არ არის დაკავშირებული ავთენტიფიცირებულ ანგარიშთან, ან პროვაიდერი ვერ პოულობს მოთხოვნილ ბრენდს ან არჩეულ ვარიანტს. მფლობელობის ადგილობრივი შემოწმებით გამოწვეული უარი ბრუნდება პროვაიდერთან მოთხოვნის გაგზავნამდე.
- რეესტრის სხვა შეცდომები: ზედა დონის სერვისის HTTP სტატუსი და სხეული უცვლელად ინახება. არასწორი ან მიუწვდომელი გამოყენების შემთხვევა არ წარმოადგენს წარმატებულ პასუხს მოთხოვნების ცარიელი ნაკრებით.
- 429: მიღწეულია ანგარიშის ან პროვაიდერის საერთო მოთხოვნების ლიმიტი. დაიცავით Retry-After-ის მითითება.
- 502/503: სატრანსპორტო კავშირის, პროვაიდერის ან მოთხოვნების სიხშირის შემზღუდველის ხელმისაწვდომობის შეფერხება. შეინარჩუნეთ ფორმა და ხელახლა სცადეთ მცდელობებს შორის დაყოვნების გაზრდით.
ხელმისაწვდომობა და თანმდევი ეფექტები
- განხილული GET ამოწმებს არსებული ბრენდის მფლობელობას, უკავშირდება რეესტრს და ქმნის მოთხოვნის აუდიტის ჩანაწერებს. იგი არ ქმნის ბრენდს ან კამპანიას და არ აკისრებს რეგისტრაციის საფასურს.
- პროვაიდერის საფასურის მეტამონაცემები არ წარმოადგენს MultiTEL-ის მომხმარებლისთვის განკუთვნილ საცალო საფასო შეთავაზებას. პორტალი ანგარიშის ფასებს ცალკე განიხილავს მოგვიანებით სარეგისტრაციო მოთხოვნის გაგზავნამდე.
- შესაბამისობა და მოთხოვნები შეიძლება შეიცვალოს. გაგზავნამდე განაახლეთ ისინი არჩეული ბრენდისა და გამოყენების შემთხვევისთვის. წარმატებული ძიება არ ნიშნავს კამპანიის დამტკიცებას, ნომრის მინიჭებას ან შეტყობინებების გაგზავნის დაწყების ნებართვას.