გამოიყენეთ ანგარიშის კუთვნილი შეტყობინებების ბრენდი
გამოიყენეთ გააქტიურებული API ანგარიში HTTPS პროტოკოლით, ნებადართული საწყისი IP მისამართიდან. მხარდაჭერილია Basic და Bearer ავთენტიფიკაცია. ბრენდის იდენტიფიკატორი ამ ანგარიშს უნდა ეკუთვნოდეს. პროვაიდერის ტოკენები, ბრენდის საიდენტიფიკაციო მონაცემები და დაბრუნებული ანგარიშები კონფიდენციალურად შეინახეთ.
შეუკვეთეთ ახალი გარე შემოწმება
გამოიყენეთ POST, როცა გჭირდებათ, რომ შემოწმების პროვაიდერმა ამ ბრენდის ახალი შემოწმება შეასრულოს. თუ პროვაიდერის შედეგი უკვე გაქვთ, გამოიყენეთ იმპორტი ახალი შემოწმების ნაცვლად. ეს ცალკე პროცედურაა; მისგან განსხვავდება ბრენდის იდენტობის ხელახალი დადასტურება.
ჯერ წაიკითხეთ ბრენდის მიმდინარე მონაცემები და დაადასტურეთ მისი საიდენტიფიკაციო ინფორმაცია. მხარდაჭერილი პროვაიდერის/კლასის შესარჩევად გამოიყენეთ მიმდინარე კატალოგები და შეამოწმეთ ამ პროვაიდერის მოთხოვნები. ყველა პროვაიდერი ყველა კლასს არ უჭერს მხარს. პოლიტიკური შემოწმებისთვის განკუთვნილი დამატებითი დეტალები უნდა აღწერდეს რეალურ ორგანიზაციას ან კამპანიას და არ უნდა შეიცავდეს სანიმუშო მონაცემებს.
მოამზადეთ პროვაიდერისთვის განკუთვნილი მოთხოვნა
| ველი | მნიშვნელობა |
|---|---|
| evpId | პროვაიდერის სავალდებულო იდენტიფიკატორი გარე შემოწმების პროვაიდერთა მიმდინარე კატალოგიდან, 1–10 სიმბოლო. |
| vettingClass | მხარდაჭერილი კლასი, რომლის შეძენასაც აპირებთ; აირჩიეთ ის პირდაპირ და დაადასტურეთ მისი ფასი. |
| additionalRequestPayload | JSON ფორმატში კოდირებული სტრიქონი პროვაიდერის სპეციფიკური დეტალებით, რომელიც პოლიტიკური შემოწმებისთვის სავალდებულოა. ეს არის გარე JSON ობიექტში მოთავსებული სტრიქონი და არა ჩადგმული ობიექტი. ყველა საჭირო დეტალი შერჩეულ პროვაიდერთან დაადასტურეთ. |
დაადასტურეთ წარმატებისა და წარუმატებლობის საფასურები
მიმდინარე საცალო საფასურები აშშ დოლარში, მონაცემები წაკითხულია 24 ოქტომბერს, 2026 წელს. რეალური შეკვეთის განთავსებამდე დაადასტურეთ მიმდინარე თანხა. წინასწარ გადახდილი სახსრების საკმარისობა მოწმდება წარმატებული შედეგის ფასთან მიმართებით; შესყიდვები ჩართული უნდა იყოს.
| კლასი | აქტიური შედეგი | წარუმატებელი შედეგი |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL — Express მოთხოვნით | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
მოლოდინის რეჟიმში მყოფ შეკვეთებს უნარჩუნდებათ წარმატებისა და წარუმატებლობისთვის განსაზღვრული თანხები და მათი ანგარიშსწორება ხდება ACTIVE ან FAILED შედეგის სინქრონიზაციისას. ბოლო ორი კლასისთვის ორივე საბოლოო შედეგზე ერთი და იგივე განსაზღვრული საფასური გამოიყენება. თუ საბოლოო შედეგი დაუყოვნებლივ მიიღება, საფასური შეიძლება შეკვეთაზე პასუხის დაბრუნების დროს ჩამოიჭრას. სტატუსის მოგვიანებით სინქრონიზაციამ შეიძლება მოლოდინში მყოფი გადასახადის ანგარიშსწორება გამოიწვიოს.
არ მიიჩნიოთ mock:true უფასო გარე შემოწმების გარანტიად. გარე შემოწმების ანგარიშსწორების მიმდინარე მექანიზმმა მაინც შეიძლება აღრიცხოს ეს შეკვეთა და მისი საფასური ჩამოჭრას. ეს ინსტრუქციები ტესტირებისთვის რეალურ შესყიდვას არ მოითხოვს; გამოიყენეთ ქსელის გარეშე გამოსაყენებელი სატესტო მონაცემები, სანამ ფასიანი შემოწმების ავტორიზაციას არ გადაწყვეტთ.
გაგზავნეთ ერთი გადამოწმებული შეკვეთა
მოამზადეთ vetting-order.json პროვაიდერის იდენტიფიკატორით, კლასითა და ყველა საჭირო დამატებითი ინფორმაციით. ფაილი შეიცავს იმ რეალურ მოთხოვნას, რომლის გაგზავნასაც აპირებთ. შეინახეთ ის კონფიდენციალურად.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"თვალი ადევნეთ რეალურ შედეგს
წარმატებული HTTP პასუხი შეიძლება შეიცავდეს მოლოდინის რეჟიმში მყოფი შემოწმების ჩანაწერს. შეინახეთ მისი vettingId და შეამოწმეთ vettingStatus, მიზეზები, ქულა და ძალაში შესვლის/ვადის გასვლის თარიღები, რამდენადაც ისინი ხელმისაწვდომია. PENDING და UNSCORE შემდგომ დაკვირვებას მოითხოვს; ACTIVE, FAILED და EXPIRED სხვადასხვა შედეგს აღწერს. მხოლოდ HTTP დონეზე მოთხოვნის მიღება არ ადასტურებს ხელსაყრელ ქულას ან კამპანიის მოთხოვნებთან შესაბამისობას.
გამოიყენეთ გარე შემოწმების სტატუსი ჩანაწერისთვის თვალის სადევნებლად. საბოლოო შედეგის წაკითხვამ ან იმპორტმა შეიძლება ადრე განთავსებული ფასიანი შეკვეთის ანგარიშსწორება გამოიწვიოს; ეს არ ნიშნავს, რომ არსებული გადაუხდელი საფასური აღარ ჩამოგეჭრებათ.
ხელახლა სცადეთ იმავე მოთხოვნის გაგზავნა
თითოეული განზრახული ოპერაციისთვის გამოიყენეთ ერთი Idempotency-Key და ზუსტად შეინარჩუნეთ მეთოდი, გზა, მოთხოვნის პარამეტრები და სხეულის ბაიტები. გასაღებებში დასაშვებია 1–128 ბეჭდვადი ASCII სიმბოლო, გამოტოვებების გარეშე. მიმდინარე ოპერაციის დუბლიკატზე შეიძლება დაბრუნდეს 409, რომელსაც ახლავს Retry-After. დასრულებული მოთხოვნების გამეორებისას ბრუნდება მათი შენახული პასუხი, შეცდომების ჩათვლით. დაიცავით მოთხოვნების სიხშირის შეზღუდვები.
გადაცემის შეცდომას შეიძლება მოჰყვეს ქეშში შენახული 502. ქეშში შენახული 500, რომელსაც ახლავს requestId, შეიძლება ნიშნავდეს, რომ რეესტრმა ოპერაცია მიიღო, მაგრამ ადგილობრივად მონაცემების შენახვა ან ანგარიშსწორება ვერ შესრულდა. შეინახეთ მოთხოვნის იდენტიფიკატორი, შეამოწმეთ მიმდინარე ჩანაწერები და ახალი გასაღების გამოყენებამდე მხარდაჭერის სამსახურთან შეაჯერეთ მდგომარეობა. არ ჩათვალოთ, რომ შეცდომა შეკვეთის არარსებობას ნიშნავს.