Directiva · Utilisaziun da l’API

Directiva d’in diever correct

OpenCaseLaw è infrastructura publica gratuita per la perscrutaziun giuridica svizra. I na dat naginas clavs API, nagina annunzia e nagina bariera da pajament. Perscrutadras, schurnalists, scolastas, advocats singuls e clients IA èn bainvegnids da duvrar libramain ils puncts d’access. Questa pagina documentescha las recumandaziuns da volumen per integraturs commerzials che pudessan uschiglio destabilisar il servetsch.

Versiun curta. In diever onest na dovra nagina coordinaziun. Sche voss product clamma in dals puncts d’access sustegnids dad in LLM (/attest, /verify-claim, /mock-decision, /exam-question, /doctrine, /trends) dapli che ~200 giadas per di e per IP, contactai nus per plaschair sut team@jonashertner.com, uschè che nus pudain conceder ina quota pli auta.

Pertge che quels puncts d’access han quotas

Ina part dals utensils publics fa diever da Claude (Anthropic) en il fund — tipicamain Sonnet-4.6, quai che custa ad OpenCaseLaw en l’urden da $0.05–$0.50 per clamada tut tenor la grondezza dal document. In integratur commerzial che integrescha in da quels utensils en in loop intern dal product po facilmain generar tschientmilli da clamadas per di e custar al project milli da dollars per di senza ch’el al sa. Las quotas existan per che quai n’arriva mai per cas.

Ils utensils betg-LLM (tschertga da text cumplet, traversaziun dal grafic da citaziuns, dumonda da leschas, recuperaziun da dottrina, metadatas da decisiuns, extracziun structurada dals considerands, etc.) n’èn betg suttamess ad ina quota. Els van sin indices SQLite locals e custan ~nagut per clamada. Da duvrar libramain.

Tabella da las quotas (stgalim gratuit / betg autentificà)

Per IP e per di, reinizialisaziun a las 00:00 UTC:

Punct d’access Num da l’utensil Clamadas / di / IP

Cura che la quota dal di vegn surpassada, dat il punct d’access enavos HTTP 429 Too Many Requests cun in corp JSON che documentescha la limita e las secundas che restan fin a la reinizialisaziun. L’intestaziun da resposta Retry-After porta il medem valur.

Tut ils auters puncts d’access han mo ina limitaziun da debit da nginx (30 req/s per IP sin /api/*, 10 req/s sin /sse, burst 50).

Quotas pli autas per il diever commerzial

Sche voss product u project da perscrutaziun dovra dapli marscha sin ils puncts d’access sustegnids dad in LLM, scrivai a team@jonashertner.com cun:

  • ina curta descripziun da quai che vus construis.
  • voss volumen mintgadi spetgà per punct d’access.
  • ils IP u ils secturs d’IP da nua che las dumondas vegnan (uschè che nus pudain confermar che il dretg clamant dovra la clav emessa).

Nus emettain per vus ina X-OCL-Key che porta in multiplicatur da quota (tipicamain 10× per integraziuns organicas sco autoritads chantunalas, fin a 100× per il diever commerzial pajà). Tramettai la clav en l’intestaziun X-OCL-Key da mintga dumonda:

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

Ils stgalims commerzials pajads vegnan facturads via Stripe a tariffas che cuvran ils custs e che correspundan radund a nossas expensas effectivas da l’API Anthropic per clamada. I na vegn agiuntà nagin marschon — il project n’ha betg in intent da profit.

Utilisadras dal supplement Word

Il stgalim Pro dal supplement Word d’OpenCaseLaw (CHF 5/mais) cumpiglia 25 clamadas dad utensils IA per di, partidas tranter las quatter funcziuns Pro (Verify, Strengthen, Find Support, Reflect). Questa quota vegn applitgada en il process da facturaziun ed è independenta da la directiva d’in diever correct survart; las utilisadras Pro na dovran nagina X-OCL-Key per il supplement Word.

Tge che nus survegliain

  • Las expensas aggregadas da l’API Anthropic, cun avis mintgadi sch’il consum è nuncorrespundent.
  • Ils contaders da quota per IP (output/quota.db), cun ina traccia d’audit dals eveniments da quota surpassada.
  • Las ratas d’errurs e las distribuziuns temporalas per utensil.

Nus na registrain betg dumondas brutas u corps da resposta — vesair la directiva da protecziun da datas per l’aggregaziun cun privatezza differenziala che nus publitgain enstagl da protocols d’access.

Sche vus cuntanschais ina quota che vus na vessas betg duvì cuntanscher

Errurs onestas capitan — caches fraids, retentativas amplifitgadas, ina cursa da benchmark scappada da la maschina da svilup. Scrivai a team@jonashertner.com cun la marca temporala + il punct d’access, e nus reinizialisain il contader e discutain co ch’il volumen real para. Nus pliras gugent vus debloccain ch’als laschar fallir en silenzi.

Questa directiva è cun intenziun lev e revisabla. Sche vus vesais nua ch’ella desavantagescha utilisaders legitims, di’ai a nus. Il corpus resta CC0; il code resta MIT; l’API resta gratuita per ils cas d’applicaziun che han motivà quest project (perscrutaziun, furmaziun, pratica individuala).