Najważniejsze zmiany
Jedno wywołanie Auto to teraz jeden request w Twoim Dashboardzie. Próby Single, Proxy Finder i Browser stojące za nim nadal tam są, wymienione z nazwy pod wywołaniem, ale Twój współczynnik sukcesu i opóźnienie są mierzone na podstawie tego, o co prosiłeś. Odrzucenie z powodu limitów Twojego planu przestało liczyć się jako ruch, Auto oznacza je jako rate limit, a strona Billing daje każdemu doładowaniu osobny wiersz.
Co nowego
Wywołania Auto liczą się jako jeden request
Wywołanie Auto pojawiało się wcześniej w Dashboardzie jako wykonane próby, więc jeden link mógł wyglądać jak kilka requestów, z których część zakończyła się błędem. Teraz Overview, Usage & Limits oraz Activity traktują Auto jako osobny produkt. Każde wywołanie to jeden wiersz z jednym wynikiem, przypisanymi kredytami i bajtami prób, które są pod nim wymienione z nazwy. Twój rate limit nadal zlicza próby, ponieważ to są requesty, które silniki faktycznie wykonują.
Otwórz Activity tuż po wywołaniu, a wiersz pokaże, że jego próby są jeszcze przetwarzane. Kilka sekund później uzupełnia listę prób, kredyty i bajty w tym samym miejscu, bez przeładowania, więc wiersz, który obserwujesz, nie przeskakuje.
Odpowiada to temu, jak Auto ma być używane. Działa jak path finder: pozwól mu znaleźć działający poziom, a następnie odtwórz zwrócony session w /api/single lub /api/browser i skieruj tam swój ruch. Activity pokazuje teraz, co sprawdzało każde wywołanie, zanim zdecydujesz się na konkretną trasę.
Odrzucenia z planu: to nie ruch, oznaczone także w Auto
Request odrzucony z powodu osiągnięcia limitu w Twoim planie nie zwiększa już całkowitego wolumenu ruchu. Nic nie zostało pobrane, więc nic nie jest naliczane. Błąd 403 lub 500 ze strony nadal się liczy, ponieważ przekazaliśmy tę odpowiedź do Ciebie.
Gdy wywołanie Auto napotka jeden z tych limitów, Activity oznacza je jako Rate Limited zamiast jako błąd, a response zawiera ten sam header X-FourA-Limit, który zwraca bezpośrednie wywołanie:
import requests
r = requests.post(
"https://api.foura.ai/api/auto",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("stopped by my plan:", limit)
else:
session = r.json().get("session") # replay on /api/single or /api/browser
Kolejna odpowiedź precyzuje teraz, co dokładnie się stało. Cel, którego nazwa hosta się nie rozwiązuje, wraca z Single, Browser, Proxy Finder i Auto tak, jak każda niedostępna witryna: status 0, błąd ze wskazaniem hosta oraz wynik celu (application_fail, zobacz outcomes). Cele w sieciach prywatnych nadal otrzymują odmowę 400.
Ruch w jednolitej jednostce
Doprecyzowaliśmy definicję gigabajta: to 1 073 741 824 bajtów dla każdego limitu i licznika. Ruch API jest liczony na podstawie zdekodowanej strony, ponieważ to tę stronę generujemy dla Ciebie, niezależnie od tego, czy wymagało to rzeczywistej przeglądarki, czy dodatkowego kroku wymaganego przez stronę. Ruch na porcie proxy jest mierzony w momencie przejścia przez tunel, gdzie przesyłamy Twoje połączenie bez ingerencji w jego zawartość. Dashboard wyświetla definicję obok statystyk ruchu, a dokument How Your Plan Is Metered opisuje pełną metodologię.
Wartości ruchu są podawane w gigabajtach wszędzie tam, gdzie towarzyszy im limit w gigabajtach, co pozwala bezpośrednio porównać bieżącą wartość z limitem. Na stronie Limits dodano panel Traffic (suma, API, port proxy i premium, każdy z paskiem postępu tam, gdzie plan określa limit), w tabeli kluczy API dodano kolumny Traffic i Premium, a każdy panel produktu w sekcji Overview pokazuje własny ruch.
Osiągnięty limit jest teraz oznaczany czerwonym statusem At limit, ponieważ kolejne żądanie zostanie odrzucone. Limit liczbowy na poziomie maksymalnym, na przykład dla kluczy API, ma kolor bursztynowy: blokuje jedynie dodanie kolejnego elementu.
Rozliczenia: cztery karty i osobny wiersz dla każdego doładowania
Strona Billing wyświetla te same cztery karty w każdym planie: najpierw kredyty lub standardowy ruch (w zależności od modelu rozliczeniowego Twojego planu), następnie drugą z tych wartości, Premium oraz port Proxy. Każda karta zawiera przycisk Buy. Jeśli Twój plan nie obejmuje danej pozycji, przycisk informuje o tym i umożliwia kontakt z nami.
W płatnym planie rozliczanym w kredytach port proxy ma własny pakiet gigabajtów w cenie, a dodatkowy transfer można dokupić bezpośrednio na jego karcie. Każde doładowanie ma własny wiersz z informacją o zakupionym pakiecie, zużyciu i pozostałym transferze. Zużycie jest pobierane w pierwszej kolejności z doładowania o najkrótszym terminie ważności.
Wiadomości e-mail o zużyciu zawierają teraz więcej szczegółów. Przy 95% otrzymujesz powiadomienie z przewidywanym dniem wyczerpania limitu przy obecnym tempie, zestawionym z datą odnowienia okresu, oraz informację o sposobie jego zwiększenia. Wiadomość przy 100% wskazuje liczbę dni pozostałych do odnowienia oraz, w planach z opcją overage, stawkę za dodatkowe zużycie.
MCP 0.7.3
FourA MCP 0.7.3 publikuje schematy narzędzi zgodne zarówno z JSON Schema draft-07, jak i 2020-12, dzięki czemu klient z restrykcyjnym walidatorem 2020-12 może wylistować i wywołać wszystkie cztery narzędzia. Format parametrów wejściowych wywołań nie uległ zmianie. Zaktualizuj pakiet @fouradata/mcp lub skorzystaj z hostowanego serwera, który działa już w wersji 0.7.3.
Dokumentacja i serwis
- Wybierz wynik w wyszukiwarce docs, a strona przewinie się do pierwszego wystąpienia szukanego słowa i je podświetli. Pierwszy wynik jest zaznaczany od razu po pojawieniu się wyników, więc Enter od razu go otwiera.
- Na telefonach i tabletach menu głównej strony otwiera się w momencie uniesienia palca i wypełnia ekran w dwóch kolumnach, a każda strona renderuje się w pełni ostylowana już w pierwszej klatce.
Pod maską
Nowe zasoby Proxy Finder startują teraz z wiedzą, którą dotychczasowe zasoby już zebrały o każdym hoście. Dzięki temu czasy odpowiedzi pozostają stabilne w trakcie ich dołączania, zamiast stabilizować się dopiero po pierwszych minutach obsługi Twojego ruchu.
Liczba w Twoim Dashboard powinna bezpośrednio odnosić się do działań Twojego zadania. Jeśli ustalenie jej źródła wymaga kalkulatora i naszej dokumentacji, to naszym zadaniem jest poprawić tę liczbę, a nie Twoim ją rozszyfrowywać.