快速回答
如何检查 SerpCrypto API 是否正常工作?
用你的密钥调用 GET https://serpcrypto.com/api/v1/credits:该调用免费,并以 JSON 返回你剩余的积分。返回 200 表示 API 和你的密钥都正常。错误 502 和 504 来自失败的搜索,且绝不会计费。SerpCrypto 会在更新日志 中发布故障事件;在实测之前不会公布任何正常运行时间数据。
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 | 账户积分已用完 | 否 | 在价格页面 购买积分包 |
429 concurrency_limit | 同时进行的搜索太多 | 否 | 减少并行请求,或申请更高的限额 |
502 search_failed | 搜索未能完成 | 否 | 稍等片刻后重试 |
504 search_timeout | 未能在规定时间内返回结果 | 否 | 稍等片刻后重试 |
问题出在我这边、你们这边,还是搜索引擎那边?
先运行免费检查,再做一次简单搜索,最后再发你的真实请求。每一步隔离一层问题。
故障事件和变更在哪里发布?
在更新日志 中。每条记录都有日期、受影响的内容(某个搜索引擎、某个字段、客户端区域或支付)以及具体变更。新增的字段也会出现在那里,这样解析器就能在需要该字段之前完成更新。
我们不单独运营状态网站,本页也不会显示可能过时的绿灯。上面的免费检查会在你询问的那一刻,告诉你该密钥下 API 的真实状态。
为什么这里没有正常运行时间百分比?
因为我们还没有用公开的方法测量过。正常运行时间数据意味着明确的探测方式、明确的时间段和明确的故障定义。等我们具备这些条件后,会在这里连同测量方法和日期一起公布。在那之前,诚实的承诺就是计费规则:1 积分 = 1 次成功的查询请求,可在任意支持的引擎上返回一页结果。失败的请求不计费。
发生故障时我该向客服提供什么?
写信到 [email protected],附上 search_metadata.id 中的请求 ID(如果没有响应,则提供请求时间)、所用搜索引擎、HTTP 状态和错误代码。切勿附上你的 API 密钥。电子邮件回复在 12 小时内,每周 7 天,包括 API 集成方面的帮助。联系页面 列出了其他能加快回复的细节。