Skip to Content
Changelog et versioning

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.

Concevez des clients tolérants. Ignorez les champs que vous ne connaissez pas et ne supposez pas d’ordre fixe dans les listes. Les changements compatibles ne vous affecteront pas.

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

v1 · 1.0.0

Spec OpenAPI publié (openapi-v1.json, v1.0.0). La référence interactive lit le spec réel. La surface de la v1 est un contrat gelé ; les changements sont annoncés ici selon la politique de dépréciation de 12 mois.

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.
Last updated on
Référence APISupport