Szybka odpowiedź
Skąd mam wiedzieć, czy WebReaderAPI działa?
Wywołaj GET https://webreaderapi.com/api/v1/credits ze swoim kluczem: to bezpłatne, a normalna odpowiedź oznacza, że API i Twój klucz działają. Jeśli strona zawiedzie, kod błędu mówi dlaczego, a WebReaderAPI nic za to nie pobiera. Incydenty po naszej stronie są zapisywane w changelogu wraz z datą.
Jaki jest najszybszy test kondycji?
Endpoint kredytów. Odpowiada bez pobierania jakiejkolwiek witryny, więc testuje tylko naszą stronę: uwierzytelnianie, API i Twoje konto.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
Które błędy pochodzą z witryny, a które od nas?
Kod błędu mówi, gdzie leży problem. Żaden z tych błędów nie zużywa kredytu.
| Kod | Gdzie leży problem | Co zrobić |
|---|---|---|
blocked_by_robots | robots.txt witryny odmawia naszemu crawlerowi | Nic: witryna powiedziała nie |
blocked_by_site_policy | Witryna deklaruje ai-input=no | Nic: witryna powiedziała nie |
target_refused | Witryna odpowiedziała 403, 429, wyzwaniem lub logowaniem | Spróbuj później lub poproś witrynę o dostęp |
fetch_failed | DNS, TLS, połączenie lub strona 404/410 | Sprawdź URL; ponów później |
fetch_timeout | Witryna nie odpowiedziała na czas | Ponów z dłuższym timeout |
concurrency_limit | Zbyt wiele zapytań naraz z Twojego konta | Zwolnij lub poproś o wyższy limit |
invalid_api_key, insufficient_credits | Twój klucz lub Twoje saldo | Sprawdź panel |
Strona błędów opisuje każdy przypadek szczegółowo, wraz z pętlą ponawiania.
Dlaczego nie ma tu aktualnego wskaźnika uptime?
Ponieważ nie zmierzyliśmy go jeszcze na publicznej próbce, a wymyślona liczba wprowadziłaby Cię w błąd. Powodzenie odczytu zależy głównie od czytanej witryny, więc pojedynczy procent niewiele by mówił. Gdy opublikujemy dane, będą im towarzyszyć metoda, próbka i data.
Gdzie ogłaszane są incydenty?
W changelogu, z datą, dotkniętymi endpointami i tym, co zrobiono. Jeśli widzisz powtarzające się błędy po naszej stronie (kody inne niż powodowane przez docelową witrynę), napisz na [email protected], podając czas zapytania i kod błędu.
Status: najczęstsze pytania
Czy sprawdzanie kredytów coś kosztuje?
Nie. GET https://webreaderapi.com/api/v1/credits nigdy nie zużywa kredytu, więc możesz wywoływać go w teście kondycji tak często, jak chcesz, w ramach limitu współbieżności.
Strona u mnie zawodzi, ale otwiera się w przeglądarce. Dlaczego?
Zwykle dlatego, że witryna traktuje roboty inaczej niż ludzi: może odmawiać naszemu crawlerowi w robots.txt lub odpowiadać na automatyczne zapytania stroną z wyzwaniem. Zwracamy jej odpowiedź i nic nie pobieramy. Kod błędu i target_status pokazują, co wysłała witryna.
Czy nieudane odczyty są kiedykolwiek płatne?
Nie. 1 kredyt = 1 odczytana strona bez przeglądarki; 2 kredyty, gdy strona wymaga przeglądarki do wyrenderowania JavaScript. Zapytanie, które się nie powiedzie lub które zostanie odrzucone przez robots.txt witryny, nie jest obciążane opłatą.