აბონენტის სახელის მოძიება

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

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

მოთხოვნა

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

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

პასუხი

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

აბონენტის სახელის ძიების ველები
ველი	მნიშვნელობა
number	მოთხოვნაში მითითებული ნომერი.
name	ხელმისაწვდომი სახელი ან მისი ჩანაცვლებითი ტექსტი. ეს ვინაობის დადასტურებას არ წარმოადგენს.
cost	ამ დამუშავების გზის მიერ დაბრუნებული ძიების ფასი, რომელიც ანგარიშისთვის/სერვისისთვისაა დაყენებული. გამოიყენეთ ანგარიშის მიმდინარე ტარიფი და არა საილუსტრაციო მნიშვნელობა.
balance	პასუხისთვის გამოთვლილი ნაშთი. ეს ანგარიშის ნაშთის ახალი ტრანზაქციული მოთხოვნა არ არის.

საფასურის დარიცხვა და მონაცემების შეჯერება

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

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

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

შეცდომები და განმეორებითი მცდელობები

შეამოწმეთ როგორც HTTP სტატუსი, ისე JSON პასუხის status.code/status.msg. API კოდი 403 შეიძლება ნიშნავდეს არასაკმარის წინასწარ გადახდილ კრედიტს, შესყიდვების აკრძალვას, ანგარიშის ავტორიზაციის პრობლემას ან იმას, რომ აბონენტის სახელი ვერ მოიძებნა. სახელის არქონის დამუშავების გზამ კოდი შეიძლება ტექსტურ სტრიქონად დააბრუნოს. შეამოწმეთ შეტყობინება და ყოველი 403 არ ჩათვალოთ არასწორი ავტორიზაციის მონაცემების ნიშნად. კონფიგურაციის კონფლიქტებისას შეიძლება დაბრუნდეს API კოდი 500.

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

ნომერთან დაკავშირებული სხვა ოპერაციები

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