Ce qui serait couvert
L'objectif de disponibilité concernerait les routes de consultation /v1/companies/{siren} et /v1/establishments/{siret} pour les forfaits payants. Les erreurs de saisie, clés invalides et réponses 404 ne constituent pas des indisponibilités du service.
Comment compter la disponibilité
La méthode envisagée est : disponibilité = 1 − minutes indisponibles / minutes du mois. Une minute serait déclarée indisponible lorsque des sondes externes constatent un délai d'attente ou des erreurs serveur persistantes sur les routes couvertes.
Les requêtes bloquées parce qu'un client dépasse son débit, utilise une mauvaise clé ou subit un problème sur son propre réseau seraient exclues du calcul. Les maintenances planifiées seraient comptées comme indisponibilité si elles interrompent les routes couvertes.
Disponibilité et fraîcheur sont distinctes
L'API peut répondre alors que la source Insee n'a pas encore publié de nouveaux changements. La synchronisation récupère les changements après leur mise à disposition par l'Insee.
La date du stock servi est accessible via /v1/metadata. Un engagement chiffré de fraîcheur sera ajouté seulement après mesure du traitement réel.
Visibilité et résolution
La supervision doit détecter les erreurs, le retard de mise à jour et la surcharge. Les modalités de communication, d'assistance et d'éventuelle compensation seront définies et publiées avant qu'un SLA contractuel entre en vigueur.