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

GET/v3/getpriceinfo/{visible_uuid}

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

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

ამ გვერდზე
  1. შენახული ფასის გეგმის წაკითხვა
  2. მოთხოვნა
  3. პასუხი
  4. ფასის ველები
  5. რამდენიმე შესატყვისი მწკრივის დამუშავება
  6. ცარიელი პასუხები და შეცდომები
  7. ეფექტები და შეზღუდვები

შენახული ფასის გეგმის წაკითხვა

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

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

მოთხოვნა

გამოიყენეთ თქვენი ჩართული API ანგარიში HTTPS-ით დაშვებული IP მისამართიდან. დააყენეთ PRICE_ID ზუსტად იმ ფასის ვარიანტის ID-ზე, რომელიც მიიღეთ. მეთოდი კითხულობს ერთ ბილიკის არგუმენტს და არ კითხულობს სხეულის, თარიღის ან პაგინაციის პარამეტრებს.

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

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

პასუხი

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response არის სია, ერთი მწკრივის შემთხვევაშიც კი. status.results ითვლის დაბრუნებულ მწკრივებს. მონაცემთა ბაზის რიცხვითი მნიშვნელობები შეიძლება იყოს სტრიქონები. ბოლო წერტილი არ ამატებს ვალუტის ველს და არ აკონვერტირებს ვალუტებს; დაადასტურეთ ანგარიშის ბილინგის ვალუტა იმის ნაცვლად, რომ ის ამ მაგალითიდან გამოიტანოთ.

ფასის ველები

ფასის გეგმის შერჩეული ველები
ველიმნიშვნელობა
visible_uuidშენახული ფასის ვარიანტის ხილული იდენტიფიკატორი. ძიების შედარებისას გამოიყენეთ ვარიანტის თავდაპირველი ID.
setup_priceამ ვარიანტისთვის შენახული ერთჯერადი დაყენების ფასი.
monthly_priceშენახული განმეორებადი ყოველთვიური ფასი.
per_minute, free_minutesშენახული შემომავალი ზარის წუთობრივი ტარიფი და ჩართული წუთების რაოდენობა. ისინი არ ასახავს გამავალი ზარების ან ყველა შესაძლო დამატებითი გადასახადის ფასს.
channelsამ ვარიანტისთვის შენახული არხების რაოდენობა; ეს არ არის რეალური დროის სიმძლავრის ან რეგისტრაციის შემოწმება.
yearly_priceშეიძლება არსებობდეს დამატებითი შენახული წლიური ფასის ველი. არ დაასკვნათ, რომ არანულოვანი ყოველთვიური ფასი და ნულოვანი წლიური ველი უფასო წლიურ გეგმას წარმოადგენს.

რამდენიმე შესატყვისი მწკრივის დამუშავება

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

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

ცარიელი პასუხები და შეცდომები

თუ არცერთი შენახული მწკრივი არ ემთხვევა, მიმდინარე დამმუშავებელი არ გამოსცემს JSON შედეგს და არც აშკარა „ვერ მოიძებნა“ პასუხს. ცარიელი სხეული არ ნიშნავს ნულოვან ფასს, ხელმისაწვდომ გეგმას ან დადასტურებულ წარმატებულ ძიებას. შეამოწმეთ როგორც HTTP პასუხი, ისე JSON სტრუქტურა; არ შეუკვეთოთ ნაკლული ან გაუანალიზებადი ფასის მონაცემების საფუძველზე.

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

ეფექტები და შეზღუდვები

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