Szybka odpowiedź
Jak sprawdzić, czy API SerpCrypto działa?
Wywołaj GET https://serpcrypto.com/api/v1/credits ze swoim kluczem: jest bezpłatne i odpowiada w JSON z liczbą pozostałych kredytów. Kod 200 oznacza, że API i Twój klucz działają. Błędy 502 i 504 pochodzą z nieudanego wyszukiwania i nigdy nie są naliczane. SerpCrypto publikuje incydenty w changelogu; nie podaje wskaźnika uptime, dopóki nie zostanie zmierzony.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"Co oznacza każda odpowiedź?
| Status HTTP | Znaczenie | Czy naliczane? | Co zrobić |
|---|---|---|---|
| 200 | API działa; w przypadku wyszukiwania wyniki znajdują się w treści odpowiedzi | 1 kredyt za udane wyszukiwanie; sprawdzenie kredytów jest bezpłatne | Nic |
401 invalid_api_key | Klucz jest nieobecny, błędny lub unieważniony | Nie | Skopiuj ponownie klucz z panelu klienta |
402 insufficient_credits | Na Twoim koncie nie ma już kredytów | Nie | Kup pakiet na stronie cennika |
429 concurrency_limit | Zbyt wiele wyszukiwań jednocześnie | Nie | Zmniejsz liczbę równoległych zapytań lub poproś o wyższy limit |
502 search_failed | Wyszukiwanie nie mogło zostać ukończone | Nie | Ponów próbę po krótkiej chwili |
504 search_timeout | Brak odpowiedzi w czasie | Nie | Ponów próbę po krótkiej chwili |
Czy problem jest po mojej stronie, po waszej, czy po stronie silnika?
Najpierw uruchom bezpłatne sprawdzenie, potem jedno proste wyszukiwanie, a na końcu swoje rzeczywiste zapytanie. Każdy krok izoluje jedną warstwę.
- Wywołanie kredytów kończy się błędem 401: problem jest z kluczem. Sprawdź format nagłówka:
Authorization: Bearer <key>, z jedną spacją. - Wywołanie kredytów działa, ale każde wyszukiwanie zwraca 502: warstwa zbierania lub silnik zawodzą dla wszystkich. Odczekaj kilka minut i ponów próbę; nic nie jest w tym czasie naliczane.
- Proste zapytanie działa, ale Twoje kończy się błędem 400: parametr jest spoza dozwolonej listy. Dokumentacja wyszukiwania wymienia każdą wartość.
- Wyniki różnią się od tych w Twojej przeglądarce: to zwykle lokalizacja, język lub urządzenie. Ustaw
gl,hl,locationidevicezgodnie z tym, co porównujesz; zobacz lokalizacje i języki.
Gdzie są publikowane incydenty i zmiany?
W changelogu. Każdy wpis ma datę, informację, czego dotyczył (silnik, pole, panel klienta lub płatności) i co się zmieniło. Dodane pole również się tam pojawia, więc parser można zaktualizować, zanim będzie potrzebował tego pola.
Nie prowadzimy osobnej strony statusu, a ta strona nie pokazuje zielonego światła, które mogłoby być nieaktualne. Bezpłatne sprawdzenie powyżej podaje rzeczywisty stan API dla Twojego klucza w momencie, gdy pytasz.
Dlaczego nie ma tu procentu uptime?
Ponieważ nie zmierzyliśmy go jeszcze za pomocą opublikowanej metody. Wskaźnik uptime oznacza zdefiniowaną sondę, zdefiniowany okres i zdefiniowaną awarię. Gdy to będziemy mieć, pojawi się tutaj wraz z metodą i datą. Do tego czasu uczciwą obietnicą jest zasada rozliczeń: 1 kredyt = 1 udane zapytanie wyszukiwania, które zwraca jedną stronę wyników na dowolnym obsługiwanym silniku. Nieudane zapytanie nie jest rozliczane.
Co powinienem przesłać do pomocy technicznej podczas incydentu?
Napisz na [email protected] z identyfikatorem żądania z search_metadata.id (lub czasem żądania, jeśli nie było odpowiedzi), silnikiem, statusem HTTP i kodem błędu. Nigdy nie dołączaj swojego klucza API. Odpowiedzi e-mail w ciągu 12 godzin, 7 dni w tygodniu, w tym pomoc przy integracji API. Strona kontaktowa wymienia inne szczegóły, które przyspieszają odpowiedź.