截作 API 鉴权

公开的截作 API 无需鉴权。没有要申请的 API 密钥，没有要轮换的令牌，也没有要创建的账号。发出请求就会被处理。访问由每 IP 速率限制约束，而不是凭据。

无需凭据

不要发送 Authorization 请求头。它会被忽略。完整请求如下：

curl -X POST https://kimte.com/api/screenshot \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

速率限制

接口	限制	说明
POST /api/screenshot	每个 IP 每分钟 20 次请求	返回 429，并带 Retry-After 和 X-RateLimit-* 响应头。
POST /api/export	不计量	受请求体大小和服务器处理时间约束。
GET /api/tweet/{id}	不计量	受上游 syndication API 约束。
GET /api/image-proxy	不计量	仅限 Twitter 媒体主机白名单。

处理 429

超出限制时，响应会带上以秒为单位的 Retry-After ，以及 X-RateLimit-Limit, X-RateLimit-Remaining和 X-RateLimit-Reset。请等待 Retry-After 后再重试。

{
  "error": "Rate limit exceeded. Please try again later.",
  "code": "rate_limited",
  "message": "Rate limit exceeded. Please try again later.",
  "hint": "Wait 42 seconds, then retry. This endpoint allows 20 requests per minute per IP address.",
  "status": 429,
  "documentation": "https://kimte.com/docs#errors",
  "retryAfter": 42
}

需凭据的维护接口

少数缓存维护接口需要维护者持有的共享密钥。它们不属于公开 API 表面，也故意没有出现在 OpenAPI 规范中。

下一步

阅读完整 API 文档，浏览开发者门户，或获取 OpenAPI 3.1 规范。