Politique · Utilisation de l’API
Politique d’usage équitable
OpenCaseLaw est une infrastructure publique gratuite pour la recherche juridique suisse. Il n’y a ni clé d’API, ni inscription, ni mur payant. Chercheurs, journalistes, enseignants, avocats individuels et clients IA sont les bienvenus pour utiliser librement les points d’accès. Cette page documente les recommandations de débit pour les intégrateurs commerciaux dont le volume pourrait sinon déstabiliser le service.
Version courte. Un usage honnête ne requiert aucune coordination. Si votre produit doit déclencher l’un des points d’accès adossés à un LLM (/attest, /verify-claim, /doctrine, /trends) plus de ~200 fois par jour et par IP, écrivez-nous à info@ki-justiz.ch afin que nous vous accordions un quota plus élevé.
Pourquoi ces points d’accès ont des quotas
Une partie des outils publics fait appel à Claude (Anthropic) en arrière-plan — typiquement Sonnet-4.6, ce qui coûte à OpenCaseLaw de l’ordre de $0.05–$0.50 par appel selon la taille du document. Un intégrateur commercial qui intègre l’un de ces outils dans une boucle produit interne peut facilement générer des dizaines de milliers d’appels par jour, coûtant au projet des milliers de dollars par jour sans en avoir conscience. Les quotas existent pour que cela n’arrive jamais par accident.
Les outils non-LLM (recherche plein texte, parcours du graphe de citations, consultation de lois, récupération de doctrine, métadonnées de décisions, extraction structurée des considérants, etc.) ne sont pas soumis à quota. Ils s’exécutent sur des index SQLite locaux et ne coûtent ~rien par appel. À utiliser librement.
Tableau des quotas (palier gratuit / non authentifié)
Par IP et par jour, réinitialisation à 00:00 UTC :
| Point d’accès | Nom de l’outil | Appels / jour / IP |
|---|
Lorsque le quota quotidien est dépassé, le point d’accès renvoie HTTP 429 Too Many Requests avec un corps JSON documentant la limite et les secondes restantes avant réinitialisation. L’en-tête de réponse Retry-After porte la même valeur.
Tous les autres points d’accès n’ont qu’une limitation de débit nginx (30 req/s par IP sur /api/*, 10 req/s sur /sse, rafale 50).
Ce que nous surveillons
- Les dépenses agrégées de l’API Anthropic, avec des alertes quotidiennes en cas de consommation inhabituelle.
- Les compteurs de quota par IP (
output/quota.db), avec une piste d’audit des dépassements de quota. - Les taux d’erreur et les distributions temporelles par outil.
Nous ne journalisons pas les requêtes brutes ni les corps de réponse — voir la politique de confidentialité pour l’agrégation à confidentialité différentielle que nous publions à la place des journaux d’accès.
Si vous atteignez un quota alors que vous n’auriez pas dû
Les erreurs honnêtes arrivent — caches froids, retentatives amplifiées, un test de référence échappé du poste de dev. Écrivez à info@ki-justiz.ch avec l’horodatage + le point d’accès, et nous réinitialiserons le compteur et discuterons de ce à quoi ressemble votre volume réel. Nous préférons vous débloquer plutôt que de vous laisser échouer en silence.
Cette politique est volontairement légère et révisable. Si vous voyez en quoi elle pénalise des utilisateurs légitimes, dites-le-nous. Le corpus reste CC0 ; le code reste MIT ; l’API reste gratuite pour les cas d’usage qui ont motivé ce projet (recherche, enseignement, pratique individuelle).