Changelog

​

v1.0.0 — Avril 2026

​

API Gateway

• 65+ 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 solvabilité 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

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