Devnors数据

统一查询

数据查询统一入口为 POST /v1/data/query。请求体与响应体均为 JSON。

生产环境接入地址：POST https://data.devnors.com/v1/data/query。

环境地址说明
prod https://data.devnors.com/v1/data/query 生产环境；须携带有效 Bearer API Key

请求体字段

字段类型必填说明
domainstring是数据域，例如 legal
typestring是数据类型，例如 case
querystring否自然语言检索词
filtersobject否结构化过滤条件；有分页时使用 filters.offset（见下方分页规则）
top_kinteger否有分页时为每页条数（1–100）；默认值见各能力文档；无分页能力文档不展示此字段

分页规则（铁律）

凡支持翻页的能力，对外只认下表两字段；不要另传「页码 / 每页条数」类参数。

用途字段说明
每页条数 top_k 取值 1–100；默认值按能力各自声明（见各能力页）
翻页偏移 filters.offset 从 0 起；建议为 top_k 的整数倍

无分页的能力文档不展示 top_k 与 offset。

成功响应示例（HTTP 200）

{
  "domain": "legal",
  "type": "case",
  "query": "民间借贷 利息",
  "total": 5,
  "total_hits": 3841,
  "units": 300,
  "request_id": "8f2c…e1",
  "status": "ok",
  "hits": [ { "case_no": "（2021）京0105民初12345号", "…" : "…" } ]
}

响应头包含 X-Request-Id（与响应体 request_id 一致），用于问题排查与对账。

curl 请求示例

curl -sS -X POST https://data.devnors.com/v1/data/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "legal",
  "type": "case",
  "query": "民间借贷 利息",
  "filters": {
    "cause": "买卖合同纠纷",
    "case_type": "民事",
    "court_level": "中级",
    "trial_procedure": "二审",
    "province": "北京市",
    "year_start": 2020,
    "year_end": 2023
  },
  "top_k": 5
}'