Odczyt zapisanego planu cenowego numeru

Odczyt zapisanego planu cenowego

Wyszukaj wiersze cen zapisane dla Twojego konta API po przeglądaniu dostępnych numerów telefonów. Użyj pola uuid opcji cenowej z listy price wybranego numeru, a nie jego numeru, identyfikatora prefiksu ani identyfikatora obszaru. Trzymaj wybrany numer i opcję cenową razem.

Jest to wyszukiwanie zapisanych cen zachowane dla zgodności. Nie odświeża ono dostępności ani cen, nie rezerwuje numeru, nie składa zamówienia ani nie gwarantuje kwoty przyszłego zakupu. Przed złożeniem zamówienia sprawdź opcję cenową zwróconą w nowym wyszukiwaniu numerów.

Żądanie

Użyj swojego włączonego konta API przez HTTPS z dozwolonego adresu IP. Ustaw PRICE_ID na dokładny identyfikator otrzymanej opcji cenowej. Metoda odczytuje jeden argument ścieżki i nie przyjmuje parametrów treści, daty ani stronicowania.

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

To wyszukiwanie musi wykonać to samo konto, które uzyskało opcję cenową. Nie konstruuj identyfikatora, nie używaj numeru wiersza bazy danych ani nie podstawiaj wyboru innego konta. Starsza metoda dopasowuje wyłącznie widoczny identyfikator ceny.

Odpowiedź

Poniższy fikcyjny przykład pokazuje tylko wybrane pola przeznaczone dla klienta. Rzeczywiste odpowiedzi zwracają kompletne zapisane wiersze i mogą zawierać dodatkowe metadane dotyczące konta, dostawcy oraz wewnętrznych cen. Przechowuj pełną odpowiedź na swoim serwerze i udostępniaj tylko te wartości przeznaczone dla klienta, których potrzebuje Twoja aplikacja.

{
  "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 jest listą, nawet dla jednego wiersza. status.results zlicza zwrócone wiersze. Wartości liczbowe z bazy danych mogą być ciągami znaków. Punkt końcowy nie dodaje pola waluty ani nie przelicza walut; potwierdź walutę rozliczeniową konta zamiast wnioskować o niej z tego przykładu.

Pola cen

Wybrane pola planu cenowego
Pole	Znaczenie
visible_uuid	Widoczny identyfikator zapisanej opcji cenowej. Przy korelowaniu wyszukiwania używaj oryginalnego identyfikatora opcji.
setup_price	Zapisana jednorazowa cena aktywacji dla tej opcji.
monthly_price	Zapisana cykliczna cena miesięczna.
per_minute, free_minutes	Zapisana stawka minutowa za połączenia przychodzące oraz liczba minut wliczonych w cenę. Nie określają one cen połączeń wychodzących ani wszystkich możliwych dopłat.
channels	Zapisana liczba kanałów dla tej opcji; nie jest to bieżące sprawdzenie pojemności ani rejestracji.
yearly_price	Może być obecne dodatkowe zapisane pole ceny rocznej. Nie wnioskuj, że niezerowa cena miesięczna i zerowe pole roczne oznaczają bezpłatny plan roczny.

Obsługa wielu pasujących wierszy

Wyszukiwanie może zwrócić więcej niż jeden zapisany wiersz. Metoda nie zapewnia gwarantowanej kolejności, wyboru najnowszego wiersza ani filtra według numeru/prefiksu. Nie wybieraj po cichu pierwszego ani ostatniego wiersza. Porównaj zwrócony kontekst z pierwotnie wybranym numerem i opcją cenową; jeśli pozostaje on niejednoznaczny lub nieaktualny, odśwież wyszukiwanie numerów zamiast traktować tę odpowiedź jako wycenę zamówienia.

Proces przeglądu zamówienia w portalu wykonuje dodatkowe kontrole wyboru i ważności. Nie zakładaj, że to starsze wyszukiwanie implementuje te kontrole ani że akceptuje każdy identyfikator akceptowany przez portal.

Puste odpowiedzi i błędy

Jeśli żaden zapisany wiersz nie pasuje, bieżąca procedura obsługi nie emituje wyniku JSON ani jawnej odpowiedzi o nieznalezieniu. Pusta treść nie oznacza ceny zerowej, dostępnego planu ani potwierdzonego udanego wyszukiwania. Sprawdzaj zarówno odpowiedź HTTP, jak i strukturę JSON; nie składaj zamówień na podstawie brakujących lub nieparsowalnych danych cenowych.

Uwierzytelnianie, ograniczenia źródłowego adresu IP i awarie bazy danych również mogą uniemożliwić uzyskanie użytecznej odpowiedzi. Nie istnieje specyficzna dla procedury obsługi koperta błędu dla wyjątku bazy danych. Odśwież swój wybór lub skontaktuj się z pomocą techniczną, gdy uwierzytelnione wyszukiwanie pozostaje niedostępne.

Skutki i ograniczenia

Przeanalizowane wyszukiwanie wykonuje zapytanie odczytu i nie zawiera obciążenia, zakupu, rezerwacji ani odświeżenia cen dostawcy. Odczyt zapisanych cen nie ustala bieżącego stanu zasobów, zgody regulacyjnej, uprawnienia konta do zakupu ani ostatecznego rozliczenia.