Trả lời nhanh
Làm sao để kiểm tra SerpCrypto API có đang hoạt động không?
Gọi GET https://serpcrypto.com/api/v1/credits với khóa API của bạn: miễn phí và trả về JSON kèm số credit còn lại. Mã 200 nghĩa là API và khóa API của bạn hoạt động. Lỗi 502 và 504 phát sinh từ một lượt tìm kiếm thất bại và không bao giờ bị tính phí. SerpCrypto đăng sự cố trong changelog; trang không công bố con số uptime nào cho đến khi được đo.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"Mỗi câu trả lời có nghĩa là gì?
| Mã trạng thái HTTP | Ý nghĩa | Có bị tính phí? | Cần làm gì |
|---|---|---|---|
| 200 | API hoạt động; với một lượt tìm kiếm, kết quả nằm trong body | 1 credit cho một lượt tìm kiếm thành công; bước kiểm tra credit là miễn phí | Không có gì |
401 invalid_api_key | Thiếu khóa, sai khóa hoặc khóa đã bị thu hồi | Không | Sao chép lại khóa API từ dashboard |
402 insufficient_credits | Tài khoản của bạn không còn credit | Không | Mua một pack ở trang giá |
429 concurrency_limit | Quá nhiều lượt tìm kiếm cùng lúc | Không | Giảm số request song song, hoặc yêu cầu giới hạn cao hơn |
502 search_failed | Không thể hoàn tất lượt tìm kiếm | Không | Thử lại sau một khoảng chờ ngắn |
504 search_timeout | Không có phản hồi kịp thời | Không | Thử lại sau một khoảng chờ ngắn |
Vấn đề nằm ở phía tôi, phía chúng tôi, hay ở engine?
Chạy bước kiểm tra miễn phí trước, rồi một lượt tìm kiếm đơn giản, rồi request thật của bạn. Mỗi bước cô lập một lớp.
- Lệnh gọi kiểm tra credit lỗi 401: vấn đề là khóa API. Kiểm tra định dạng header:
Authorization: Bearer <key>, với một dấu cách. - Lệnh gọi kiểm tra credit chạy được nhưng mọi lượt tìm kiếm đều trả 502: lớp thu thập hoặc engine đang lỗi với tất cả mọi người. Chờ vài phút rồi thử lại; trong lúc đó không bị tính phí.
- Một truy vấn đơn giản chạy được nhưng truy vấn của bạn lỗi 400: một parameter nằm ngoài danh sách cho phép. Tài liệu tham chiếu tìm kiếm liệt kê mọi giá trị.
- Kết quả khác với trình duyệt của bạn: thường là do vị trí, ngôn ngữ hoặc thiết bị. Đặt
gl,hl,locationvàdevicecho khớp với thứ bạn đang so sánh; xem vị trí và ngôn ngữ.
Sự cố và thay đổi được đăng ở đâu?
Trong changelog. Mỗi mục có ngày, thứ bị ảnh hưởng (một engine, một field, khu vực client hoặc thanh toán) và những gì đã thay đổi. Một field được thêm cũng xuất hiện ở đó, để parser có thể được cập nhật trước khi cần đến field đó.
Chúng tôi không vận hành một trang trạng thái riêng, và trang này không hiển thị đèn xanh nào có thể đã lỗi thời. Bước kiểm tra miễn phí ở trên cho bạn biết trạng thái thực của API với khóa API của bạn, ngay tại thời điểm bạn hỏi.
Tại sao ở đây không có phần trăm uptime?
Vì chúng tôi chưa đo được con số đó bằng một phương pháp được công bố. Một con số uptime cần có probe xác định, khoảng thời gian xác định và định nghĩa lỗi xác định. Khi có, nó sẽ xuất hiện ở đây kèm phương pháp và ngày. Cho đến lúc đó, cam kết trung thực là quy tắc tính phí: 1 credit = 1 truy vấn tìm kiếm thành công, trả về một trang kết quả trên bất kỳ engine nào được hỗ trợ. Truy vấn thất bại không bị tính phí.
Tôi nên gửi gì cho bộ phận hỗ trợ khi có sự cố?
Viết tới [email protected] kèm request ID từ search_metadata.id (hoặc thời điểm của request nếu không có phản hồi), engine, mã trạng thái HTTP và mã lỗi. Không bao giờ kèm khóa API của bạn. Phản hồi email trong vòng 12 giờ, 7 ngày một tuần, bao gồm cả hỗ trợ tích hợp API. Trang liên hệ liệt kê các chi tiết khác giúp trả lời nhanh hơn.