Changelog

Historique des changements de la Kinmu Public API. Les changements incompatibles ne sont jamais appliqués au sein d’une version majeure : ils sont introduits dans une nouvelle version et annoncés ici.

Politique de versioning

• La version figure dans l’URL : https://api.kinmu.app/v1.
• Contrat gelé au sein de v1. Nous n’introduisons aucun changement incompatible dans v1.

Ce que nous considérons comme un changement compatible (ne casse rien)

Ces changements peuvent survenir dans v1 sans préavis ; votre intégration doit les tolérer :

• Ajouter de nouveaux endpoints ou de nouvelles ressources.
• Ajouter de nouveaux champs à une réponse.
• Ajouter de nouvelles valeurs à un enum documenté comme extensible (p. ex. les types d’absence personnalisés).
• Ajouter des paramètres optionnels de query ou de body.
• Modifier le texte des messages d’erreur (title, detail) — c’est pourquoi votre logique doit s’appuyer sur le champ stable code.

Ce que nous considérons comme un changement incompatible (casse)

Requiert une nouvelle version majeure (v2) :

• Supprimer ou renommer un endpoint, un champ ou une valeur d’enum.
• Changer le type d’un champ ou le rendre obligatoire.
• Changer la signification d’un champ ou le code d’une erreur.

Politique de dépréciation (12 mois)

Quand nous déprécions un endpoint, un champ ou une version :

1. La dépréciation est annoncée dans ce changelog et sur la liste de diffusion des développeurs.
2. L’élément est marqué deprecated dans le spec OpenAPI et, le cas échéant, via les headers de réponse Deprecation + Sunset.
3. Il reste opérationnel au moins 12 mois après l’annonce avant d’être retiré.

Abonnez-vous aux annonces sur la page de support.

Historique

2026-08-27 — spec OpenAPI et updated_since

• La spec déclare désormais les codes 402 et 409 ainsi que les en-têtes X-RateLimit-*, que l’API émettait déjà.
• Le 409 est en outre déclaré sur POST /v1/reports et sur les opérations idempotentes de webhooks, où il manquait.
• updated_since implémenté sur GET /v1/webhook-endpoints.
• updated_since marqué obsolète (deprecated) sur GET /v1/vacation-balances et GET /v1/work-summaries : il n’a jamais filtré sur ces ressources. Il reste accepté sans effet — pour ne pas casser les SDK régénérés — et sera retiré le 27/08/2027, conformément à la politique de dépréciation de 12 mois. Pour ces agrégats, redemandez la plage (year, from/to). Voir les conventions.

2026-08-20 — e-mail du salarié unique par entreprise

• L’unicité de l’e-mail à la création d’un salarié devient par entreprise (elle était globale). Les créations qui échouaient en 422 à cause d’une collision avec l’e-mail d’une autre entreprise sont désormais acceptées.

2026-08-10 — la sandbox et les clés sont déprovisionnées

• Désactiver l’addon Public API révoque toutes les clés API (motif addon_disabled), supprime les rapports générés et supprime l’entreprise sandbox avec ses données. Réactiver l’addon reprovisionne une sandbox vide et ne restaure pas les clés. Voir sandbox.

2026-07-31 — gate d’abonnement et révocation

• Le gate d’abonnement se durcit : essai épuisé, abonnement résilié arrivé à terme, abonnement expiré et entreprise archivée renvoient désormais 403 subscription_inactive sur /v1.
• Révoquer des clés API et des webhooks (DELETE) n’exige plus d’abonnement actif : couper une credential est un contrôle de sécurité et doit rester possible en toutes circonstances.

2026-07-30 — réglages d’entreprise à l’émission des clés

• L’émission des clés API respecte les réglages de l’addon par entreprise : default_expiration_days (expiration appliquée quand vous n’en demandez pas explicitement) et max_active_keys (plafond de clés actives, 10 par défaut).

v1 · 1.0.0

Ressources du lancement (MVP) :

• Organization — GET /v1/organization (introspection).
• Employees — lister, consulter, créer, mettre à jour et gérer le départ.
• Check-ins — lister, consulter et enregistrer des pointages.
• Work summaries — agrégats de temps de travail pour la paie.
• Absences — lister, consulter, créer, approuver et refuser.
• Vacation balances — soldes de congés.
• Locations / Units — structure organisationnelle (lecture seule).
• Reports — rapports asynchrones (registre légal du temps de travail et exports), avec téléchargement du fichier via GET /v1/reports/{id}/download.

Webhooks :

• Événements sortants signés (Standard Webhooks) : gestion des endpoints, envoi de ping, liste des livraisons et remise en file manuelle d’une livraison via POST /v1/webhook-endpoints/{id}/deliveries/{deliveryId}/retry.