Limites et restrictions

Les limites qui protègent l'API et vos clients. En usage normal, vous ne les atteignez pas.

Limite	Valeur	Au-delà
Appels par clé API	120 par minute (ajustable sur demande)	`trop_de_requetes`
Appels depuis une même adresse IP	600 par minute	`trop_de_requetes`
Taille du corps	256 Ko	`requete_invalide`
Âge d'une signature	5 minutes	`signature_expiree`
Validité d'un devis	15 jours	`devis_expire`
Souscriptions par devis	1	`devis_deja_souscrit`
Date d'effet	Au plus tard dans 90 jours	`validation`
Contrats par page	1 à 100 (20 par défaut)	Ramené dans ces bornes
Clé d'idempotence	24 heures	Peut resservir

Format des données reçues

JSON valide, encodé en UTF-8 ;
aucun caractère de contrôle dans les textes (le caractère nul, par exemple, est refusé) ;
les champs inconnus sont ignorés, et un montant envoyé n'est jamais pris en compte : le prix vient toujours de l'API.

Restrictions de votre compte

COVERAF peut, à votre demande ou selon votre convention :

limiter vos offres : GET /v1/produits ne liste que les vôtres, les autres renvoient offre_non_autorisee ;
limiter les adresses IP : votre clé ne fonctionne que depuis vos serveurs, ailleurs ip_non_autorisee. Fortement recommandé en production ;
plafonner les primes non reversées (mode A) : au-delà, plafond_encours_atteint jusqu'au reversement.

Réagir à une limite

Sur trop_de_requetes, attendez quelques secondes puis réessayez, en espaçant vos appels. Pour suivre un paiement, préférez les notifications à des consultations répétées.