Aide / Klepsi / Clés d'API

Lire les données de Klepsi par l'API

Une clé d'API donne à Power BI, Excel ou un script un accès en lecture seule aux données de Klepsi. Elle se crée en quelques clics par un administrateur.

Vérifiez que le module API est actif

Dans Paramètres, onglet Modules, le module API doit être coché. Sans lui, toute clé est refusée, même valide. Selon votre abonnement, le module peut ne pas être proposé : écrivez-nous dans ce cas.

Créez une clé

Dans Paramètres, onglet Données, bloc Clés d'API : donnez un Nom qui dit à quoi elle sert (« Power BI direction », par exemple), puis Créer une clé.

La clé commence par tk_. Elle ne s'affiche qu'une seule fois : copiez-la dans votre coffre de mots de passe. La liste montre ensuite sa date de dernière utilisation.

Une clé agit au nom de l'administrateur qui l'a créée, en lecture seule. Elle voit tout ce qu'il voit. Si ce compte est désactivé, la clé cesse de fonctionner. Révoquez une clé dès qu'elle ne sert plus.

Passez-la dans l'en-tête Authorization

Chaque appel porte l'en-tête Authorization: Bearer tk_…. Seule la lecture (GET) est acceptée : une écriture répond 403. Remplacez votre-instance par l'adresse de votre Klepsi.

curl -H 'Authorization: Bearer tk_…' \
  'https://votre-instance/api/v1/tasks/?date_from=2026-09-01&date_to=2026-09-30'

Les adresses utiles

Toutes commencent par https://votre-instance/api/v1 et renvoient du JSON, sauf mention contraire.

Adresse	Contenu
`/tasks/`	Les saisies de temps. Filtres : `date_from`, `date_to`, `project_id`, `user_id`.
`/projects/`	Les projets.
`/clients/`	Les clients.
`/users/`	Les utilisateurs.
`/teams/`	Les équipes.
`/reports/generate`	Le compte rendu d'une période, en `csv`, `xlsx`, `json` ou `pdf`. Paramètres obligatoires : `date_from` et `date_to`. Facultatifs : `format`, `group_by` (`project` ou `user`), `client_id`, `project_id`.
`/absences`	Les absences, si le module est actif.
`/expenses`	Les notes de frais, si le module est actif.
`/settings/data/export`	L'export complet de l'instance, en zip de fichiers CSV.

Les dates s'écrivent AAAA-MM-JJ. Gardez la barre finale des adresses qui en ont une.

Dans Excel ou Power BI

Les deux passent par Power Query. Le plus simple est de partir d'une requête vide et de coller le code dans l'Éditeur avancé :

let
    Source = Json.Document(Web.Contents(
        "https://votre-instance/api/v1/tasks/",
        [
            Query = [date_from = "2026-09-01", date_to = "2026-09-30"],
            Headers = [Authorization = "Bearer tk_…"]
        ]
    )),
    Saisies = Table.FromRecords(Source)
in
    Saisies

Quand Power Query demande comment se connecter, choisissez Anonyme : la clé est déjà dans l'en-tête.

Pour un tableau prêt à l'emploi, l'adresse /reports/generate avec format=csv se lit par Csv.Document à la place de Json.Document.

La clé est écrite en clair dans le classeur ou le rapport. Ne partagez pas le fichier au-delà des personnes qui pourraient voir ces données dans Klepsi.

Besoin d'aide ?

Notre équipe support peut vous accompagner pour ce réglage. Écrivez-nous à support@aleop.eu.