# Trạng thái API: cách kiểm tra hoạt động

> Kiểm tra SERP API của SerpCrypto có hoạt động không: lệnh gọi miễn phí, ý nghĩa HTTP status, lỗi không tính phí và nơi đăng sự cố.

- URL: https://serpcrypto.com/vi/status/
- Cập nhật lần cuối: 2026-10-22
- Đơn vị phát hành: SerpCrypto (https://serpcrypto.com)

Trang này không có widget trạng thái nào công bố con số uptime. Thay vào đó, đây là bước kiểm tra bạn có thể tự chạy trong một dòng, và cách đọc câu trả lời.

**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](https://serpcrypto.com/vi/changelog/); trang không công bố con số uptime nào cho đến khi được đo.

*Kiểm tra tình trạng miễn phí (không dùng credit)*

```bash
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á](https://serpcrypto.com/vi/pricing/) |
| 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.

1. **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.
2. **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í.
3. **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](https://serpcrypto.com/vi/docs/search/) liệt kê mọi giá trị.
4. **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`, `location` và `device` cho khớp với thứ bạn đang so sánh; xem [vị trí và ngôn ngữ](https://serpcrypto.com/vi/docs/locations/).

## Sự cố và thay đổi được đăng ở đâu?

Trong [changelog](https://serpcrypto.com/vi/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 support@serpcrypto.com 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ệ](https://serpcrypto.com/vi/contact/) liệt kê các chi tiết khác giúp trả lời nhanh hơn.

---

SerpCrypto: SerpCrypto là SERP API cho lập trình viên và AI agent, trả về kết quả Google và Bing dưới dạng JSON, thanh toán bằng crypto mà không cần tải lên giấy tờ tùy thân. Credit tìm kiếm trả trước từ 0,30 US$/1K lượt tìm kiếm không bao giờ hết hạn. Không cần KYC — không ID, không selfie, không giấy tờ. Thanh toán bằng crypto.