სატელეფონო სადგურის მობილური ნომრების მარაგის შემოწმება

აირჩიეთ მხარდაჭერილი პრეფიქსი

გამოიყენეთ discovery-დან აღებული მიმდინარე ინდივიდუალური მობილური პრეფიქსი. ეს endpoint განკუთვნილია NANPA სატელეფონო სადგურებისთვის: NPA აღნიშნავს არეის კოდს, ხოლო NXX — სატელეფონო სადგურს. მხოლოდ არეის კოდის შემცველი პრეფიქსი ძალიან ფართოა. არ გაგზავნოთ დაჯგუფებული საჩვენებელი ID-ები და არ ჩათვალოთ, რომ სხვა ქვეყანა მხარდაჭერილია მხოლოდ იმიტომ, რომ მისი პრეფიქსი საკმარის ციფრს შეიცავს.

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

წაიკითხეთ response.count, response.npa და response.nxx სატელეფონო სადგურის იდენტიფიცირებისთვის. ეს არის დაფარვის სერვისის მიმდინარე მდგომარეობის სურათი და არა თქვენი ანგარიშისთვის დაჭერილი მარაგი. დაადასტურეთ რეალური ნომრები, შესაბამისი ფასის შეთავაზებები და ნებისმიერი სარეგისტრაციო მოთხოვნა შეკვეთამდე. წარმატებული რაოდენობა არასოდეს ავტორიზებს შესყიდვას.

განასხვავეთ ნულოვანი მარაგი ჩავარდნილი ძიებისგან

ნულოვანი რაოდენობის წარმატებული შედეგი განსხვავდება API-ის შეცდომისგან. შეამოწმეთ status.code და status.msg ისევე როგორც HTTP სტატუსი. მიიჩნიეთ ტაიმაუთი ან ჩავარდნილი ძიება უცნობი ხელმისაწვდომობის მდგომარეობად და მოგვიანებით სცადეთ ხელახლა თანდათანობითი დაყოვნებით.

მოთხოვნა

გამოიყენეთ თქვენი ჩართული API ანგარიშის ავტორიზაციის მონაცემები HTTPS-ის საშუალებით. მხარდაჭერილია Basic ავთენტიფიკაცია და ჩართული API-ანგარიშის bearer ტოკენები; ვრცელდება ანგარიშის შეზღუდვები.

GET პრეფიქსის იდენტიფიკატორით URL-ის ბილიკში. დოკუმენტირებული query ან body პარამეტრები არ არსებობს.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

პასუხი

შეამოწმეთ status.code JSON-ის სხეულში ისევე როგორც HTTP სტატუსი. წარმატებულ response აქვს status.code 200 და status.msg Results. response არის ობიექტი და არა სია: count არის მთელი რიცხვითი ინვენტარის მიმდინარე მდგომარეობის სურათი; npa და nxx არის სამსიმბოლოვანი სტრიქონები. status.results ამ ასოციატიური ობიექტისთვის არ არსებობს. 0 რაოდენობა ნიშნავს, რომ დაფარვის ძიებას შესაბამისი სატელეფონო სადგური არ ჰქონდა ან დააბრუნა ნულოვანი მარაგი; ეს არ მოწმობს, რომ ყველა მომწოდებელს ან სხვა discovery გზას ნომრები საერთოდ არ აქვს.

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

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

შეცდომები

• 404: მომწოდებელი გამორთულია: მობილური ინვენტარის დაფარვა სერვისზე ხელმისაწვდომი არ არის.
• 404: არასწორი პრეფიქსის ID: მიიღეთ მიმდინარე ინდივიდუალური პრეფიქსის ID discovery-დან.
• 404: არასწორი პრეფიქსი: შენახული პრეფიქსი არ შეიცავს NPA/NXX ძიებისთვის საკმარის ციფრს.
• 500: ინვენტარის დაფარვა ჩავარდა: upstream ძიებამ დაფარვის წარმატებული შედეგი არ დააბრუნა. სცადეთ მოგვიანებით ხელახლა თანდათანობითი დაყოვნებით; ჩავარდნა ნულოვანი მარაგის რაოდენობა არ არის.

ხელმისაწვდომობა და გვერდითი ეფექტები

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