დეველოპერებისთვის

GET/v3/nanpacheck/{number}

შეამოწმეთ ჩრდილოეთ ამერიკის ნომრების განაწილების ცხრილში მოცვა

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

ამ გვერდზე
  1. შეამოწმეთ განაწილების ცხრილში მოცვა
  2. მოთხოვნა
  3. პასუხი
  4. შეცდომები
  5. ღირებულება და შემდეგი ნაბიჯები

შეამოწმეთ განაწილების ცხრილში მოცვა

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

მოთხოვნა

გამოიყენეთ თქვენი ჩართული API ანგარიში და ნებადართული წყაროს IP მისამართი. მაგალითში გამოყენებულია გარემოს ცვლადებიდან მიღებული HTTP Basic ავთენტიფიკაციის მონაცემები და გამოგონილი ნომერი. მოთხოვნის სხეული საჭირო არ არის.

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

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

პასუხი

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

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}
განაწილების ცხრილში ნაპოვნი შესაბამისობის ველები
ველიმნიშვნელობა
numberნორმალიზებული შეყვანილი მნიშვნელობა, რომელიც მხოლოდ ციფრებს შეიცავს.
npanxxშენახული პრეფიქსი, რომელთანაც შესაბამისობა მოიძებნა. დამმუშავებელი უპირატესობას ანიჭებს ქვეყნის/რეგიონის/სატელეფონო სადგურის შვიდციფრიან პრეფიქსს და სათადარიგოდ შეუძლია ქვეყნის/რეგიონის ოთხციფრიანი პრეფიქსის გამოყენება; ნუ ჩათვლით, რომ ეს ველი ყოველთვის სატელეფონო სადგურის სრულ პრეფიქსს განსაზღვრავს.
city, state, countryმეტამონაცემები განაწილების იმ პრეფიქსისთვის, რომელთანაც შესაბამისობა მოიძებნა. ეს ველები არ განსაზღვრავს აბონენტის ამჟამინდელ ფიზიკურ ადგილმდებარეობას ან ნომრის პორტირების შემდეგ მის ამჟამინდელ ოპერატორს.

შეცდომები

წაიკითხეთ JSON პასუხის status.code ველი და მხოლოდ HTTP 200-ს ნუ დაეყრდნობით. API კოდი 404 შეტყობინებით Not part of NANPA ნიშნავს, რომ სერვისის მიერ გამოყენებულ ცხრილში შესაბამისი პრეფიქსი ვერ მოიძებნა; ეს არ წარმოადგენს ნუმერაციის გლობალური უფლებამოსილი ორგანოს საბოლოო დასკვნას. API კოდი 500 გამოიყენება ციფრების არასწორი რაოდენობის ან ნომრის არარსებობის შემთხვევაში.

ღირებულება და შემდეგი ნაბიჯები

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