用途:通过 scripts/judilibre_client.py 调用 Judilibre API(最高法院),检索并阅读司法法院判决,认证与返回均为 JSON。
覆盖范围:最高法院各庭,并逐步纳入上诉法院和一审法院;不覆盖法律条文(法典、法律、法令)及行政法院判例(最高行政法院、上诉行政法院、行政法庭),此类需求应转向 OpenLegi/Légifrance 等来源。
配置:需 PISTE 密钥和网络授权。推荐 KeyId 模式,密钥按 --key、环境变量 JUDILIBRE_KEY_ID、scripts/config.json 顺序读取;无密钥则报错,需向用户索取并参照 scripts/config.example.json 创建 config.json,填入 key_id 并将 env 设为 prod 或 sandbox,OAuth 字段留空。OAuth2 为高级回退方案,填 client_id/client_secret 并留空 key_id。config.json 明文存密钥,切勿展示或分享。网络需允许 api.piste.gouv.fr(生产 KeyId),sandbox-api.piste.gouv.fr 仅沙箱,oauth.piste.gouv.fr 与 sandbox-oauth.piste.gouv.fr 仅 OAuth2。
用法:必要时 pip install requests。验证:python3 scripts/judilibre_client.py test(真实认证检索)。检索示例:python3 scripts/judilibre_client.py search "période d'essai rupture abusive" --chamber soc --page-size 10。可选过滤:--chamber、--jurisdiction、--type、--theme、--publication、--solution、--field、--operator、--date-start、--date-end、--page、--page-size(最大 50)、--sort、--order;类别过滤可多值空格分隔。读取全文:python3 scripts/judilibre_client.py decision <id>,返回 text、url 和 zones。查询过滤值:python3 scripts/judilibre_client.py taxonomy chamber。
结果呈现:不要直接输出原始 JSON,应按相关性列出判决,含法院与庭、上诉编号、日期、裁判结果、公布级别、简短摘要和公开链接,保留 id 以便按需打开全文,并提示仅为司法法院判决。
错误处理:脚本返回含 error 与 fix 的 JSON。缺密钥则索取并写入 config.json;401 为密钥或环境错误;403 为未接受 Judilibre 使用条款或 API 未关联 PISTE 应用;429/5xx 为配额或不可用,脚本会自动重试,否则稍后重试;连接失败或域名未授权则需在代码执行网络设置中允许 api.piste.gouv.fr。