API 概览

KeepFlow API 围绕 REST 设计。我们的 API 拥有可预测的、面向资源的 URL，接受 JSON 编码的请求体，返回 JSON 编码的响应，并使用标准的 HTTP 响应码。

基础 URL

https://api.keepflow.ai/v1

请求格式

所有请求都必须包含：

• Content-Type: application/json 请求头
• Authorization: Bearer <api_key> 请求头

响应格式

所有响应都遵循一致的结构：

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-15T10:30:00Z"
  }
}

错误处理

错误会返回相应的 HTTP 状态码，并附带描述性的消息：

{
  "error": {
    "code": "invalid_request",
    "message": "The 'email' field is required."
  }
}