ხელმისაწვდომი მობილური ნომრების პოვნა

დარწმუნდით, რომ მობილური მარაგი ჩართულია

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

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

შეინახეთ თითოეული ნომერი საკუთარ ფასის არჩევანთან ერთად

თითოეული კანდიდატისთვის ერთად შეინახეთ number, info.uuid და იმავე ჩანაწერის price სია. პასუხი ასევე შეიცავს პრეფიქსის/არეალის/ქვეყნის მეტამონაცემებს, კონტრაქტის პირობებსა და რეგისტრაციის შეზღუდვებს. კანდიდატები დალაგებულია მათი პირველი ფასის ვარიანტის ყოველთვიური ფასის მიხედვით, ზრდადობით; თანაბარი ფასებისთვის სტაბილური თანმიმდევრობა გარანტირებული არ არის. არ ჩაანაცვლოთ დაბრუნებული ნომრის ID არეალის ან პრეფიქსის ID-ით და არ დააწყვილოთ ის სხვა კანდიდატის ფასის ID-სთან.

სრული პასუხი შეიძლება შეიცავდეს დამატებით მეტამონაცემებსა და ფასის ველებს. დაბრუნებული features, არხების მნიშვნელობები და restrictions აღწერს კანდიდატს; ისინი არ არის გარანტია, რომ ზარები, SMS, MMS ან ფაქსი უკვე გამოსაყენებელია. ანგარიშის უფლებები, რეგისტრაცია და არჩეული სერვისის გეგმა კვლავ მოქმედებს. არ მიიჩნიოთ მაგალითის ჩამნაცვლებლები მოქმედ ID-ებად ან ფასებად.

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

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

განასხვავეთ მარაგის არარსებობა ძიების შეცდომისგან

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

შესყიდვამდე ხელახლა შეამოწმეთ

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

მოთხოვნა

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

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

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

პასუხი

შეამოწმეთ status.code და status.msg JSON სხეულში, ისევე როგორც HTTP სტატუსი. წარმატების შემთხვევაში response არის ნომრების კანდიდატების სია, status.msg არის Results:, რომელსაც მოჰყვება დაბრუნებული რაოდენობა, ხოლო status.results არის სერიალიზებული სიის სიგრძე. კანდიდატების ფასები ანგარიშზეა დამოკიდებული. საილუსტრაციო შემოკლებული მაგალითი რეალური მარაგის ან ტარიფის შეთავაზების ნაცვლად ჩამნაცვლებლებს იყენებს. ნომრები ქვეყნის კოდს პლუსის ნიშნის გარეშე შეიცავს; იდენტიფიკატორები გაუმჭვირვალე სტრიქონებია.

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

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

შეცდომები

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

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

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