Présentation de l'API

L'API KeepFlow est organisée autour du principe REST. Notre API repose sur des URL prévisibles et orientées ressources, accepte des corps de requête encodés en JSON, renvoie des réponses encodées en JSON et utilise les codes de réponse HTTP standard.

URL de base

https://api.keepflow.ai/v1

Format des requêtes

Toutes les requêtes doivent inclure :

• l'en-tête Content-Type: application/json
• l'en-tête Authorization: Bearer <api_key>

Format des réponses

Toutes les réponses suivent une structure cohérente :

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

Gestion des erreurs

Les erreurs renvoient les codes de statut HTTP appropriés, accompagnés d'un message descriptif :

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