Обзор API

API KeepFlow построен на принципах 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."
  }
}