# API 状态：如何检查其是否正常工作

> 检查 SerpCrypto SERP API 是否正常工作：免费积分调用、每个 HTTP 状态的含义、哪些错误永远不会计费以及事件发布在哪里。

- URL: https://serpcrypto.com/zh/status/
- 最后更新: 2026-10-22
- 发布者: SerpCrypto (https://serpcrypto.com)

本页没有显示正常运行时间数据的监控组件。下面给出你可以自己用一行命令执行的检查方法，以及如何解读返回结果。

**快速回答 — 如何检查 SerpCrypto API 是否正常工作？**

用你的密钥调用 `GET https://serpcrypto.com/api/v1/credits`：该调用免费，并以 JSON 返回你剩余的积分。返回 200 表示 API 和你的密钥都正常。错误 502 和 504 来自失败的搜索，且绝不会计费。**SerpCrypto** 会在[更新日志](https://serpcrypto.com/zh/changelog/) 中发布故障事件；在实测之前不会公布任何正常运行时间数据。

*免费健康检查（不消耗积分）*

```bash
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"
```

## 每种返回结果代表什么？

| HTTP 状态 | 含义 | 是否计费？ | 如何处理 |
| --- | --- | --- | --- |
| 200 | API 正常工作；对于搜索请求，结果在响应体中 | 一次成功的搜索计 1 积分；积分查询免费 | 无 |
| 401 `invalid_api_key` | 密钥缺失、错误或已撤销 | 否 | 从控制台重新复制密钥 |
| 402 `insufficient_credits` | 账户积分已用完 | 否 | 在[价格页面](https://serpcrypto.com/zh/pricing/) 购买积分包 |
| 429 `concurrency_limit` | 同时进行的搜索太多 | 否 | 减少并行请求，或申请更高的限额 |
| 502 `search_failed` | 搜索未能完成 | 否 | 稍等片刻后重试 |
| 504 `search_timeout` | 未能在规定时间内返回结果 | 否 | 稍等片刻后重试 |

## 问题出在我这边、你们这边，还是搜索引擎那边？

先运行免费检查，再做一次简单搜索，最后再发你的真实请求。每一步隔离一层问题。

1. **积分调用返回 401：**问题出在密钥。检查请求头格式：`Authorization: Bearer <key>`，中间只有一个空格。
2. **积分调用正常，但每次搜索都返回 502：**采集层或搜索引擎对所有人都出现了故障。等几分钟后重试；期间不会产生任何费用。
3. **简单查询正常，但你的请求返回 400：**某个参数超出了允许的取值列表。[搜索参考文档](https://serpcrypto.com/zh/docs/search/) 列出了所有取值。
4. **结果和你在浏览器里看到的不一样：**这通常是地区、语言或设备不同导致的。把 `gl`、`hl`、`location` 和 `device` 设置成与你对比时所用的一致；参见[地区与语言](https://serpcrypto.com/zh/docs/locations/)。

## 故障事件和变更在哪里发布？

在[更新日志](https://serpcrypto.com/zh/changelog/) 中。每条记录都有日期、受影响的内容（某个搜索引擎、某个字段、客户端区域或支付）以及具体变更。新增的字段也会出现在那里，这样解析器就能在需要该字段之前完成更新。

我们不单独运营状态网站，本页也不会显示可能过时的绿灯。上面的免费检查会在你询问的那一刻，告诉你该密钥下 API 的真实状态。

## 为什么这里没有正常运行时间百分比？

因为我们还没有用公开的方法测量过。正常运行时间数据意味着明确的探测方式、明确的时间段和明确的故障定义。等我们具备这些条件后，会在这里连同测量方法和日期一起公布。在那之前，诚实的承诺就是计费规则：1 积分 = 1 次成功的查询请求，可在任意支持的引擎上返回一页结果。失败的请求不计费。

## 发生故障时我该向客服提供什么？

写信到 support@serpcrypto.com，附上 `search_metadata.id` 中的请求 ID（如果没有响应，则提供请求时间）、所用搜索引擎、HTTP 状态和错误代码。切勿附上你的 API 密钥。电子邮件回复在 12 小时内，每周 7 天，包括 API 集成方面的帮助。[联系页面](https://serpcrypto.com/zh/contact/) 列出了其他能加快回复的细节。

---

SerpCrypto: SerpCrypto 是面向开发者和 AI Agent 的 SERP API，可将 Google 和 Bing 搜索结果以 JSON 返回，用加密货币支付，无需上传证件。预付费搜索积分自 US$0.30/千次搜索 起永不过期。无需 KYC——无需证件、无需自拍、无需材料。加密货币支付。