Authentification

URL de base

https://app.kawlya.com/api/integrations/v1

Clé Bearer

Chaque requête nécessite l’en-tête Authorization. La clé commence par kwl_ suivi de 48 caractères hexadécimaux. Elle représente l’identité de l’entreprise ; ne transmettez pas d’identifiant de tenant supplémentaire.

Authorization: Bearer kwl_<48 hex chars>

Création et révocation

Créez les clés dans Intégrations → API & Webhooks. La valeur n’est affichée qu’à la création ; seul un hash SHA-256 est conservé côté serveur. Une clé inconnue ou révoquée renvoie la même réponse 401.

Vérifier l’identité

curl 'https://app.kawlya.com/api/integrations/v1/me' -H "Authorization: Bearer $KAWLYA_API_KEY"

{
  "tenant": {
    "id": 42,
    "name": "Garage Dupont"
  }
}

Limites et erreurs

La limite est de 120 requêtes par minute et par clé. Un dépassement renvoie 429 avec Retry-After: 60. Attendez avant de réessayer. Une réponse 401 indique une clé absente ou invalide. Lors de la création d’un webhook, 403 not-entitled indique que l’offre ne dispose pas du droit integrations.