> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finkare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Historique des versions et évolutions de l'API Finkare.

## v1.0.0 — Avril 2026

**Lancement de l'API Finkare**

### API Gateway

* 43+ endpoints REST (v1 et v2)
* Authentification par API Key (`X-API-Key`)
* OAuth 2.1 avec Client Credentials, Authorization Code + PKCE, Refresh Token
* 15 scopes granulaires
* Rate limiting par tier (Starter, Pro, Enterprise)
* Idempotence via header `Idempotency-Key`
* Compression gzip (seuil 1 Ko)
* Cache-Control et ETag sur les endpoints de lecture
* Timeout interceptor configurable

### Factures

* Import unitaire et en masse (jusqu'à 100 par requête)
* Filtres avancés (statut, débiteur, date, montant, recherche textuelle)
* Données financières immuables après import
* Annulation de recouvrement avec arrêt du workflow

### Workflow IA

* Orchestration Mistral AI des cascades de relances
* 5 actions : start, pause, resume, cancel, escalate
* Prochaine action planifiée consultable via l'API
* Historique complet des actions de recouvrement
* 7 gardes anti-harcèlement intégrés

### Paiements

* Consultation des paiements reçus (totaux et partiels)
* Filtres par statut, période et facture
* Statistiques agrégées par période

### Débiteurs

* CRUD complet
* Score de risque IA (13 critères, 0-195)
* Facteurs explicatifs (conformité AI Act)

### Webhooks

* 15 types d'événements
* Signature HMAC-SHA256
* Retry automatique avec backoff exponentiel (5 tentatives)
* Historique des deliveries
* Rotation de secret

### Agent Bob

* Interface conversationnelle en langage naturel (v2)
* Outils internes pour consulter et agir sur les dossiers
* Historique des conversations

### Sécurité

* TLS 1.3, HSTS preload
* Audit logs immutables (hash chain SHA-256)
* PII masking dans les logs
* Headers de sécurité complets (Helmet)

### SDK TypeScript

* Client officiel `@finkare/api-sdk`
* Retry automatique sur 429 (backoff exponentiel)
* Pagination async iterator
* Types TypeScript complets

***

## Conventions de versioning

L'API Finkare suit le [Semantic Versioning](https://semver.org/) :

* **MAJOR** (v1 → v2) : changements non rétrocompatibles
* **MINOR** (v1.1) : nouvelles fonctionnalités rétrocompatibles
* **PATCH** (v1.0.1) : corrections de bugs

Les changements non rétrocompatibles sont annoncés **6 mois** à l'avance. Les endpoints dépréciés retournent le header `Deprecation` et le code d'erreur `SYS_003`.