მარშრუტიზაციის ინფორმაციის მოძიება
მოითხოვეთ მარშრუტიზაციის ინფორმაცია ჩრდილოეთ ამერიკის ტელეფონის ნომრისთვის. გამოიყენეთ იგი ხელმისაწვდომი მარშრუტიზაციისა და ოპერატორის მონაცემების გასაგებად და არა აბონენტის ვინაობის, ნომრის საკუთრების, ნომერთან დაკავშირების შესაძლებლობის ან შესაძენად ხელმისაწვდომობის დასადასტურებლად. მოძიებამ შეიძლება თქვენს ანგარიშზე თანხის ჩამოჭრა გამოიწვიოს.
მოთხოვნა
გამოიყენეთ თქვენი გააქტიურებული API ანგარიში და მისთვის ნებადართული წყაროს IP მისამართი. მიუთითეთ სრული ნომერი მხოლოდ ციფრებით, ქვეყნის კოდის 1 ჩათვლით. მაგალითში გამოყენებულია გარემოს ცვლადები და გამოგონილი ნომერი. დამმუშავებელი პუნქტუაციის ნიშნებს ნორმალიზაციას არ უკეთებს; გაგზავნამდე შეამოწმეთ შეყვანილი მონაცემების სისწორე.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/lrn/12025550123პასუხი
საილუსტრაციოდ ნაჩვენებია მხოლოდ შერჩეული ველები; მათი ხელმისაწვდომობა დამოკიდებულია წყაროსა და ნომრის ტიპზე.
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ocn": "0000",
"local": 1,
"ported": 0,
"cost": "$0.00025"
}
}სტანდარტული მოძიება დაბრუნებული ველების სახელებს პატარა ასოებად გარდაქმნის. წყაროს მიხედვით, პასუხი შეიძლება შეიცავდეს ოპერატორის, სატარიფო ცენტრის, მდებარეობისა და იურისდიქციის ველებს. პასუხი არ წარმოადგენს აბონენტის ფიქსირებული შემადგენლობის სრულ ჩანაწერს. local ალამი შეიძლება იყოს რიცხვითი მნიშვნელობა 1 ან სტრიქონული მნიშვნელობა 0. დამმუშავებელი ported მნიშვნელობას დაბრუნებული მარშრუტიზაციის ნომრისა და მითითებული ტელეფონის ნომრის შედარებით გამოთვლის; ნუ მიიჩნევთ მას ნომრის პორტირების დადასტურებულ სრულ ისტორიად.
ფასი და განმეორებითი მცდელობები
განხილული დამმუშავებელი ანგარიშიდან ჩამოჭრის $0.00025 თანხას, როდესაც შესრულების დასრულების გზას მიაღწევს და მოძიებას აღრიცხავს. დაბრუნებული ღირებულება ჩვეულებრივ არის დოლარის ნიშნის შემცველი სტრიქონი და არა მხოლოდ რიცხვითი თანხა. იდემპოტენტურობის გასაღები ხელმისაწვდომი არ არის. მოთხოვნის გამეორებამ შეიძლება თანხის ხელახლა ჩამოჭრა გამოიწვიოს.
წინასწარი გადახდის ანგარიშებისთვის კოდი ამოწმებს, არის თუ არა ბალანსი სულ მცირე 0.00025. არასაკმარისი ბალანსის შესახებ შეტყობინებაში ამჟამად მითითებულია $5, რაც ამ ზღვარს არ შეესაბამება. ეს წარუმატებლობა აღიქვით როგორც ბალანსის გამო უარი და ხელახლა ცდამდე გადაამოწმეთ ანგარიშზე თანხის არსებობა.
წარუმატებლობები და არასრული წარმატება
შეამოწმეთ როგორც HTTP სტატუსი, ისე JSON ფორმატის status.code/status.msg ველები. სტანდარტული მოძიების ცარიელი შედეგი აბრუნებს API კოდს 404. API კოდი 403 შეიძლება მიუთითებდეს წინასწარი გადახდის არასაკმარის ბალანსზე.
უფასო ზარის ნომრებისთვის ამჟამად არსებული შეცდომის დამუშავების ერთ-ერთ გზას მაინც შეუძლია მოძიების თანხის ჩამოჭრა და API კოდის 200 დაბრუნება გამოსადეგი მარშრუტიზაციის ველების გარეშე; ღირებულების მონაცემიც შეიძლება არასრული იყოს. ამიტომ მხოლოდ კოდი 200 არ ადასტურებს, რომ მოძიების შედეგი გამოსაყენებელია. შეამოწმეთ თქვენი აპლიკაციისთვის საჭირო ველები, გაურკვეველი ჩამოჭრები შეადარეთ ანგარიშის ბილინგის ჩანაწერებს და არასრული შედეგების შემთხვევაში დაუკავშირდით მხარდაჭერის სამსახურს.
განხილულ რეალიზაციაში უფასო ზარის ნომრების დამუშავება შეყვანილი მონაცემების სიგრძის მიხედვით განსხვავდება. უპირატესობა მიანიჭეთ ციფრებით ჩაწერილ სრულ საერთაშორისო ნომერს და მხარდაჭერის სამსახურთან გადაამოწმეთ, ვრცელდება თუ არა მომსახურება თქვენთვის საჭირო უფასო ზარის ნომრებზე. არ გაიმეოროთ მოთხოვნა ავტომატურად არასწორი ფორმატის ან არასრული შედეგის მიღებისას და ნუ დაეყრდნობით მარშრუტიზაციის ინფორმაციის მოძიებას იმის გადასაწყვეტად, უსაფრთხოა თუ არა ნომერზე დარეკვა ან გაქვთ თუ არა ამის ნებართვა.