დაათვალიერეთ შაბლონების კატალოგი
სერვისის მიერ დაბრუნებული შაბლონების ჩამოსათვლელად გამოტოვეთ მისამართის გზის არასავალდებულო ISO სეგმენტი. სიის გასაფილტრად მიუთითეთ ქვეყნის ISO კოდი. ფილტრი ეძებს შაბლონის ქვეყნის მინიშნებასთან დამთხვევას; ეს მინიშნება შეიძლება სახელიდან იყოს გამოტანილი და შეიძლება ცარიელიც იყოს.
შაბლონი მოთხოვნების მიხედვით შეარჩიეთ
შაბლონის არსებობა არ ნიშნავს, რომ ის ამ ქვეყნის ყველა ნომრისთვის სავალდებულო ან მისაღებია. შაბლონის იდენტიფიკატორი შეადარეთ დამადასტურებელი დოკუმენტების შესაბამის მოთხოვნებს. ეს ჩამონათვალი არ ქმნის, ხელს არ აწერს, არ ატვირთავს და არ ამტკიცებს შევსებულ დოკუმენტს.
თუ შაბლონები არ დაბრუნდა
ცარიელი გაფილტრული სია შეიძლება ნიშნავდეს, რომ ქვეყნის შესაბამისი მინიშნება ვერ მოიძებნა. ცარიელი გაუფილტრავი სია ასევე შეიძლება მონაცემთა პირველწყაროს მიუწვდომლობით იყოს გამოწვეული. არცერთი შედეგი არ მიიჩნიოთ იმის მტკიცებულებად, რომ დამადასტურებელი დოკუმენტი საჭირო არ არის.
გამოყენებამდე შეამოწმეთ ჩამოტვირთული ასლი
კატალოგში მოცემულმა ჩამოტვირთვის ბმულმა შეიძლება დააბრუნოს ასლი შეცვლილი ფორმატირებით ან ბრენდული გაფორმებით. ნუ ჩათვლით, რომ ეს უცვლელი თავდაპირველი შეთანხმებაა ან რომ მისი ჩამოტვირთვით რეგისტრაციის მოთხოვნა სრულდება. ნებისმიერი დოკუმენტის შევსებამდე ან ხელმოწერამდე შეამოწმეთ მისი შინაარსი.
თუ პორტალის დოკუმენტების მომზადების დამხმარე გთავაზობთ შეთანხმების მომზადებას, გამოიყენეთ მისი წინასწარი დათვალიერებისა და ცალსახა გაგზავნის პროცესი. სხვა საჭირო ფორმების შემთხვევაში, შევსებამდე MultiTEL-თან გადაამოწმეთ ფორმის მოქმედი ვერსია. ჩამოტვირთული შაბლონი არ წარმოადგენს ხელმოწერილ დანართს, ატვირთულ დამადასტურებელ მასალას ან ნომრის დამტკიცებას.
მოთხოვნა
გამოიყენეთ თქვენი ჩართული API ანგარიშის ავტორიზაციის მონაცემები HTTPS-ის მეშვეობით. მხარდაჭერილია Basic ავთენტიფიკაცია და ჩართული API ანგარიშის bearer ტოკენები; მოქმედებს ანგარიშის შეზღუდვები.
გამოიყენეთ GET და ნებისმიერი დოკუმენტირებული პარამეტრი URL-ის გზაში მიუთითეთ.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"| სახელი | ტიპი | სავალდებულო | აღწერა |
|---|---|---|---|
iso | string | არა | ქვეყნის არასავალდებულო ISO ფილტრი. გაუფილტრავი სიის მისაღებად გამოტოვეთ გზის ეს სეგმენტი მთლიანად. შედარებისას ასოების რეგისტრი არ გაითვალისწინება. უცნობი ან შეუსაბამო მნიშვნელობების შემთხვევაში ბრუნდება ცარიელი სია და არა არასწორი ქვეყნის აშკარა შეცდომა. |
პასუხი
HTTP სტატუსთან ერთად შეამოწმეთ JSON-ის სხეულში მოცემული status.code. response არის ობიექტების მასივი, რომელთა ველებია id, name, permanent, iso და url. permanent არის boolean ტიპის მნიშვნელობა; iso შეიძლება ცარიელი იყოს და შეიძლება შაბლონის სახელიდან იყოს გამოტანილი. ქვეყნის შესახებ ინფორმაცია მინიშნებად მიიჩნიეთ და არა შესაბამისობის შესახებ გადაწყვეტილებად. ცარიელი კატალოგი წარმატებული 200 პასუხია და შეიძლება მაშინაც დაბრუნდეს, როცა პირველწყაროში ძიება მონაცემებს არ იძლევა. URL-ს სერვისი ქმნის; მისი ჰოსტის სახელი შეიძლება საილუსტრაციო მაგალითისგან განსხვავდებოდეს.
პასუხის საილუსტრაციო სტრუქტურა; ეს არ არის ანგარიშის მიმდინარე მონაცემები ან მოქმედი ფასის შეთავაზება.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "TEMPLATE_ID_FROM_RESPONSE",
"name": "Example supporting-document template",
"permanent": false,
"iso": "US",
"url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
}
]
}შეცდომები
- ავთენტიფიკაციის ან სერვისის შეცდომების გამოსავლენად შეამოწმეთ status.code და status.msg. წარმატებული პასუხით დაბრუნებული ცარიელი კატალოგი არ ნიშნავს დოკუმენტის დამტკიცებას ან რეგისტრაციისგან გათავისუფლებას.
ხელმისაწვდომობა და თანმდევი მოქმედებები
- კატალოგში/მოთხოვნებში ეს ძიება არ ქმნის პირადობის ჩანაწერს, არ ატვირთავს დამადასტურებელ მასალას, არ არეგისტრირებს ნომერს და არ ათავსებს შეკვეთას.
- კატალოგის წარმატებული პასუხი არ ნიშნავს თქვენი დოკუმენტების დამტკიცებას ან იმის დადასტურებას, რომ არჩეული ნომრის გააქტიურება შესაძლებელია.