Jak rozliczany jest Twój plan
FourA sprzedaje dwa produkty i są one rozliczane w różnych jednostkach. Twój plan bazuje na jednej z tych dwóch jednostek, co decyduje o tym, który limit Cię blokuje i jakie karty widzisz w panelu. Ta strona przedstawia cały model na jednym ekranie.
Dwa produkty, dwie jednostki
| Produkt | Co wywołujesz | Jednostka |
|---|---|---|
| API | POST /api/single, /api/proxy, /api/browser, /api/auto |
Request, wyceniany w kredytach |
| Proxy port | proxy.foura.ai:34004 z dowolnego klienta obsługującego proxy URL |
Tunel, wyceniany w gigabajtach |
W API tylko wynik success kosztuje kredyty. Request, który nie powiódł się po stronie celu, po Twojej stronie lub po naszej, nic Cię nie kosztuje. Ruch premium jest liczony niezależnie od kredytów, jak opisano poniżej. Zobacz Request Outcomes.
Na proxy port nie ma kredytów ani licznika requestów i nie jest to przeoczenie. Tunel to pojedyncze połączenie otwierane przez Twoje narzędzie, a to, co przez nie przesyła, to Twój własny zaszyfrowany ruch. FourA może więc zliczać tunel oraz przesłane bajty i nic bardziej szczegółowego. Liczba requestów w tym miejscu byłaby wartością, której nigdy nie udałoby się uzgodnić z Twoimi własnymi logami. Port jest zatem zawsze sprzedawany na gigabajty. Zobacz Proxy Port.
Czym jest gigabajt i co się w niego wlicza
Jeden gigabajt oznacza 1 073 741 824 bajty (2^30, jednostka zapisywana również jako GiB). Każdy limit, licznik i cena w Twoim planie korzysta z tej wartości, zarówno w API, jak i na proxy port.
To, co jest zliczane, różni się w zależności od produktu, ponieważ oba przenoszą różne dane:
| Gdzie | Co jest zliczane |
|---|---|
| API, wyjścia standardowe | Ciało requestu wysyłanego do nas plus ciało response zwracanego przez nas. Nagłówki HTTP nie są zliczane po żadnej ze stron. |
| API, wyjścia premium | Każdy bajt transferu przesyłany przez sieć w obu kierunkach, w postaci skompresowanej i zaszyfrowanej podczas transmisji. |
| Proxy port | Każdy bajt przechodzący przez tunel w obu kierunkach po jego otwarciu, w tym konfiguracja szyfrowanego połączenia wykonywana przez Twojego klienta ze stroną. Otwarcie tunelu nie jest zliczane, z wyjątkiem sytuacji, gdy wyjście premium testowane przez port i niewykorzystane podczas otwierania tunelu jest zaliczane jako ruch premium. |
Kilka konsekwencji, o których warto wiedzieć:
- Strona jest rozliczana w postaci zdekodowanej, ponieważ to zdekodowaną stronę dostarczamy. Dotarcie do niej może wymagać uruchomienia prawdziwej przeglądarki, wykonania dodatkowego kroku wymaganego przez witrynę, a następnie zdekodowania odpowiedzi i przekazania gotowej do użycia treści. Płacisz za ten rezultat, a nie za to, jak skompresowany był przesyłany pakiet. Port proxy to inny przypadek i jest wyceniany inaczej: tam przesyłamy Twoje własne połączenie i nie modyfikujemy jego zawartości, więc liczymy bajty dokładnie tak, jak przechodzą przez tunel.
- Ponowne próby w puli standardowej nic Cię nie kosztują. Gdy Proxy Finder rotuje przez kilka węzłów wyjściowych, płacisz raz, za otrzymaną odpowiedź, bez względu na liczbę wypróbowanych wyjść. Na węźle premium liczy się każda próba, ponieważ w taki sposób rozliczają nas sieci premium.
- Sesja przeglądarki na wyjściu standardowym jest liczona jak każda inna odpowiedź API: liczy się treść, którą zwracamy, a nie każdy zasób podrzędny załadowany przez stronę. Przez wyjście premium cała sesja przechodzi przez sieć i tam jest zliczana.
- Premium stanowi część Twojego całkowitego limitu, a nie dodatek do niego. Twój standardowy pakiet jest obciążany tylko za tę część, która nie przeszła przez węzeł premium.
- Wywołanie Auto nie generuje własnego ruchu. Żądania Single, Proxy Finder i Browser, które wykonuje, są liczone tak, jakby zostały wykonane bezpośrednio przez Ciebie.
- Odmowa ze strony witryny jest zliczana; odmowa wynikająca z Twojego planu nie jest. Gdy witryna zwraca 403, 404, 429 lub 5xx, przesłaliśmy tę odpowiedź do Ciebie, więc jest ona wliczana. Gdy żądanie zostanie odrzucone przez limit w Twoim planie, nic nie jest pobierane i nic nie jest naliczane.
- Nic nie jest zaokrąglane w górę. Bajty są liczone precyzyjnie, bez narzuconego rozmiaru bloku i bez minimalnego progu na żądanie, a Twoje statystyki są uzgadniane co noc z naszym magazynem metryk.
Dwa sposoby rozliczania planu
Oba liczniki działają dla każdego konta. To, w jaki sposób Twój plan jest sprzedawany, określa różnice.
Sprzedaż na podstawie kredytów
API pobiera kredyty za każde rozliczone żądanie. Port proxy otrzymuje własny pakiet gigabajtów, wyceniany osobno, ponieważ tunel nie posiada pojedynczego żądania, za które można by pobrać kredyt. Te dwie pule nie wpływają na siebie: ruch z API nie zużywa gigabajtów portu, a tunele portu nie zużywają Twoich kredytów. Alternatywą byłoby podwójne naliczanie za jedno żądanie API: raz w kredytach i raz w bajtach wygenerowanych przez te kredyty.
Własny limit transferu API jest wyłączony, chyba że Twój plan go przewiduje.
Sprzedaż na podstawie transferu
Jeden standardowy pakiet transferu obejmuje łącznie API oraz port proxy, ponieważ oba kanały są wyceniane w tej samej jednostce. Plan sprzedawany w ten sposób nie nalicza kredytów, więc kredyty całkowicie znikają z panelu, zamiast wyświetlać bezużyteczną wartość.
Ruch premium w obu modelach
Ruch premium ma zawsze swój własny limit w każdym rodzaju planu. Nigdy nie jest wliczany do wartości standardowej, więc żaden gigabajt nie jest naliczany podwójnie do dwóch limitów. Dostęp do węzła premium uzyskujesz za pomocą exitClass: premium w POST /api/proxy/ lub -network-premium na porcie proxy.
Jest mierzony w momencie przesyłania przez sieć: w obu kierunkach, w postaci skompresowanej i zaszyfrowanej tak, jak został przesłany. W API liczy się każda próba premium, łącznie z tą, która nie zwróciła strony. Na porcie proxy jest to transfer każdego tunelu premium oraz każdego węzła wyjściowego premium, z którym port próbował nawiązać połączenie i je porzucił podczas otwierania.
Co i gdzie powoduje odrzucenie
| Limit | W API | Na porcie proxy |
|---|---|---|
| Kredyty na okres | 429 z X-FourA-Limit: plan_limit_credits |
Nie dotyczy |
| Standardowy transfer na okres | 429 z X-FourA-Limit: plan_limit_bandwidth |
429 z X-Foura-Error wskazującym transfer |
| Jednocześnie otwarte tunele | Nie dotyczy | 429 z X-Foura-Error |
| Otwierane tunele na minutę | Nie dotyczy | 429 z X-Foura-Error |
| Transfer premium | Zdegradowany, nieodrzucony | 403 przy jawnym żądaniu |
Odpowiedź CONNECT nie ma treści, w której można umieścić błąd JSON. Z tego powodu odrzucenie na porcie ma postać statusu wraz z nagłówkiem, a nie struktury opisanej w sekcji Rate Limits. Przy połączeniu proxy odczytaj X-Foura-Error przed czymkolwiek innym.
Wyczerpanie premium to jedyna asymetria
Oba punkty wejścia celowo odpowiadają inaczej, ponieważ „chcę wydać środki” oraz „coś zostało dla mnie wcześniej skonfigurowane” to dwie różne sytuacje.
W API wyczerpany limit premium nigdy nie zatrzymuje zadania. Żądanie jest obsługiwane z puli standardowej, a odpowiedź zawiera exitClass: standard, dzięki czemu widać, co faktycznie zostało zwrócone. Plan, który w ogóle nie obejmuje wyjść premium, zwraca inną odpowiedź: jest to 403 z plan_limit_premium.
Na porcie proxy:
- Połączenie wskazujące
-network-premiumzostaje odrzucone z kodem403. Zgłoszono chęć wydania środków, więc cicha obsługa z innego źródła utrudniłaby rozliczenie pozycji premium, która się nie pojawi. - Domyślna opcja premium zapisana na użytkowniku proxy zostaje zdegradowana do sieci współdzielonej, a tunel nadal się otwiera. Nie została ona wybrana bezpośrednio dla tego połączenia.
- Uzbrojony
-fallback-premiumpo prostu się nie uruchamia.
Dokupowanie zasobów
Doładowania działają dokładnie tak samo, jak zasoby zawarte w planie. W każdym okresie najpierw wykorzystywany jest limit z planu, a dopiero nadwyżka jest pobierana z zakupionego salda. Zakup jest ważny przez dwanaście miesięcy.
Pulpit nawigacyjny rozdziela te dwie wartości wszędzie tam, gdzie podaje limit (75,000 (50,000 incl + 25,000 bought)), dzięki czemu liczbę na ekranie można łatwo uzgodnić z fakturą.
Gdzie sprawdzić własne dane liczbowe
| Strona | Jakie informacje zawiera |
|---|---|
| Billing | Bieżący okres w zestawieniu z dostępnymi zasobami, osobna karta dla każdej pozycji mierzonej w planie, z przyciskiem zakupu na każdej z nich |
| Usage & Limits | Każdy limit obok licznika na żywo, wraz z podziałem na klucze, punkty końcowe i użytkowników proxy |
| Overview | Wolumen i transfer w dowolnym okresie, w podziale na produkty |
To, które karty wyświetla Billing, zależy od dwóch powyższych przypadków: plan rozliczany w kredytach otrzymuje kartę Credits oraz kartę Proxy port traffic; plan rozliczany według transferu nie otrzymuje żadnej z nich, a jego karta Standard traffic zawiera limit i komunikat The API and the proxy port together.
Nie wpisuj żadnej z tych liczb na stałe w kodzie. Każda odmowa ze strony API zawiera limit, który ją wywołał, a każda odmowa portu wskazuje go w X-Foura-Error.
Powiązane
- Rate Limits: Wszystkie body i nagłówki limitów planu w API
- Proxy Port: Pomiary, kody odpowiedzi i opcje nazwy użytkownika
- Request Outcomes: Które wyniki generują opłaty dla żądań i tuneli
- Billing & Subscriptions: Plany, doładowania i faktury
- Usage & Limits: Liczniki na żywo względem limitów planu