Politica · Uso dell’API

Politica di uso corretto

OpenCaseLaw è un’infrastruttura pubblica gratuita per la ricerca giuridica svizzera. Non ci sono chiavi API, né registrazione, né paywall. Ricercatori, giornalisti, docenti, singoli avvocati e client IA sono benvenuti a usare liberamente gli endpoint. Questa pagina documenta le indicazioni di volume per gli integratori commerciali il cui carico potrebbe altrimenti destabilizzare il servizio.

In breve. L’uso onesto non richiede alcun coordinamento. Se il vostro prodotto invoca uno degli endpoint basati su LLM (/attest, /verify-claim, /mock-decision, /exam-question, /doctrine, /trends) più di ~200 volte al giorno per IP, contattateci a team@jonashertner.com così possiamo concedervi una quota più alta.

Perché questi endpoint hanno quote

Un sottoinsieme degli strumenti pubblici si appoggia a Claude (Anthropic) dietro le quinte — tipicamente Sonnet-4.6, che costa a OpenCaseLaw nell’ordine di $0.05–$0.50 per chiamata a seconda della dimensione del documento. Un integratore commerciale che incorpora uno di questi strumenti in un ciclo interno di prodotto può facilmente generare decine di migliaia di chiamate al giorno, costando al progetto migliaia di dollari al giorno senza esserne consapevole. Le quote esistono affinché questo non accada mai per errore.

Gli strumenti non-LLM (ricerca a testo intero, attraversamento del grafo delle citazioni, consultazione di leggi, recupero di dottrina, metadati delle decisioni, estrazione strutturata dei considerandi, ecc.) non sono soggetti a quota. Funzionano su indici SQLite locali e costano ~nulla per chiamata. Usateli liberamente.

Tabella delle quote (livello gratuito / non autenticato)

Per IP al giorno, azzeramento alle 00:00 UTC:

Endpoint Nome dello strumento Chiamate / giorno / IP

Quando la quota giornaliera viene superata, l’endpoint restituisce HTTP 429 Too Many Requests con un corpo JSON che documenta il limite e i secondi rimanenti fino all’azzeramento. L’intestazione di risposta Retry-After riporta lo stesso valore.

Tutti gli altri endpoint hanno solo il rate limiting di nginx (30 req/s per IP su /api/*, 10 req/s su /sse, burst 50).

Quote più alte per l’uso commerciale

Se il vostro prodotto o progetto di ricerca necessita di più margine sugli endpoint basati su LLM, scrivete a team@jonashertner.com indicando:

  • una breve descrizione di ciò che state costruendo.
  • il volume giornaliero atteso per endpoint.
  • gli IP o intervalli di IP da cui proverranno le richieste (così da confermare che il chiamante corretto stia usando la chiave emessa).

Emettiamo per voi una X-OCL-Key, che porta un moltiplicatore di quota (tipicamente 10× per integrazioni organiche come le amministrazioni cantonali, fino a 100× per l’uso commerciale a pagamento). Inviate la chiave nell’intestazione X-OCL-Key di ogni richiesta:

curl -H "X-OCL-Key: ocl_xxxxxxxx..." \
     -H "Content-Type: application/json" \
     -d '{"draft_text": "..."}' \
     https://mcp.opencaselaw.ch/api/attest

I livelli commerciali a pagamento sono fatturati tramite Stripe a tariffe di recupero costi che corrispondono all’incirca alla nostra effettiva spesa per l’API Anthropic per chiamata. Non viene aggiunto alcun margine — il progetto è senza scopo di lucro.

Utenti del componente aggiuntivo per Word

Il livello Pro del componente aggiuntivo Word di OpenCaseLaw (CHF 5/mese) include 25 chiamate agli strumenti IA al giorno, condivise tra le quattro funzioni Pro (Verify, Strengthen, Find Support, Reflect). Questa quota è applicata nel percorso di fatturazione ed è indipendente dalla politica di uso corretto sopra; gli utenti Pro non hanno bisogno di una X-OCL-Key per il componente aggiuntivo Word.

Cosa monitoriamo

  • La spesa aggregata per l’API Anthropic, con avvisi giornalieri quando il consumo è insolito.
  • I contatori di quota per IP (output/quota.db), con traccia di controllo degli eventi di quota superata.
  • I tassi di errore e le distribuzioni temporali per strumento.

Non registriamo query grezze o corpi di risposta — si veda l’informativa sulla privacy per l’aggregazione a privacy differenziale che pubblichiamo al posto dei log di accesso.

Se raggiungete una quota che non avreste dovuto

Gli errori onesti capitano — cache fredde, retry amplificati, un’esecuzione di benchmark sfuggita dalla macchina di sviluppo. Scrivete a team@jonashertner.com con marca temporale + endpoint, e azzereremo il contatore e discuteremo di come appare il vostro volume reale. Preferiamo sbloccarvi piuttosto che lasciarvi fallire in silenzio.

Questa politica è volutamente snella e rivedibile. Se vedete in che modo penalizza utenti legittimi, ditecelo. Il corpus resta CC0; il codice resta MIT; l’API resta gratuita per i casi d’uso che hanno motivato questo progetto (ricerca, formazione, pratica individuale).