# 工劳网 (Gonglao)

> 工劳网是关注中国劳工议题的中文新闻资料库，收录经编辑筛选的劳工新闻文章（含劳工权益视角的列点摘要、主题/行业/议题/地区标注）与劳动争议判决文书资料库。全站数据通过完全公开、只读、无需认证的 JSON API 提供。

重要说明：

- API base URL 为本站根路径，无需 API key，支持 CORS（任意来源）。
- 调用搜索前建议先读取 /api/v1/vocabularies，了解所有过滤参数的合法值。
- 参数错误时返回 400，响应中会列出该参数允许的值，可据此自行修正。
- 日期参数格式为 YYYY-MM-DD；分页参数 page 从 1 开始，per_page 最大 50。
- 搜索结果中 title 与 match_snippet 可能包含 <mark> 高亮标签。

## API

- [文章全文搜索](/api/v1/articles/search): GET，参数 q、page、per_page、order、range、start_date、end_date、theme[]、content_type[]、industry[]、occupation[]、issues[]、loc_p[]、origin[]，返回命中列表 + facet 统计
- [文章列表](/api/v1/articles): GET，按文章日期倒序分页，默认来源 tg（编辑收录），可加 origin[] 参数
- [文章详情](/api/v1/articles/{id}): GET，返回全文、摘要与全部标注
- [按原始 url 查文章](/api/v1/articles/by-url?url=...): GET
- [判决文书全文搜索](/api/v1/lawcases/search): GET，参数 q、page、per_page、order、range、start_date、end_date、province[]、caseLevel[]
- [判决文书详情](/api/v1/lawcases/{id}): GET
- [过滤词汇表](/api/v1/vocabularies): GET，所有过滤参数的合法值
- [OpenAPI 3.0 规范](/api/v1/openapi.json): 机读接口定义

## 文档

- [人类可读 API 文档](/api/v1/docs)
- [完整机读文档（含全部词汇表与示例）](/llms-full.txt)

## 其它

- [RSS 订阅](/rss.xml)