{"service":"Devnors数据","description":"为 AI Agent 而建的高质量数据 API：一个 API Key 调用官方权威数据，出处可回溯。","version":"0.1.0","updated":"2026-07-14","base_url":"https://data.devnors.com","endpoint":{"method":"POST","path":"/v1/data/query","url":"https://data.devnors.com/v1/data/query"},"auth":{"type":"bearer","header":"Authorization: Bearer devnors_sk_...","get_key":"https://data.devnors.com/console"},"request_schema":{"domain":"string（必填，如 legal）","type":"string（必填，如 case / law_article / law_catalog）","query":"string（自然语言检索词）","filters":"object（按能力，见 capabilities[].filters；分页用 filters.offset:int 配合 top_k）","top_k":"integer 1-200（默认 20）"},"capabilities":[{"domain":"legal","type":"case","status":"live","label":"裁判文书","description":"检索中国裁判文书(官方公开,出处可回溯)。自然语言 query + 可选结构化 filters。","filters":[{"name":"cause","type":"string","desc":"案由关键词(模糊)","example":"买卖合同纠纷"},{"name":"case_type","type":"string","desc":"案件类型:刑事/民事/行政/执行/国家赔偿","example":"民事"},{"name":"court_level","type":"string","desc":"法院层级:基层/中级/高级/最高","example":"中级"},{"name":"trial_procedure","type":"string","desc":"审判程序:一审/二审/申请再审/再审/执行","example":"二审"},{"name":"province","type":"string","desc":"省级行政区","example":"北京市"},{"name":"city","type":"string","desc":"市级行政区","example":"深圳市"},{"name":"region","type":"string","desc":"地域(省或市)","example":"北京"},{"name":"case_level","type":"string","desc":"案件层级:general/guiding(指导性案例)","example":"guiding"},{"name":"year_start","type":"integer","desc":"裁判年份下界(含)","example":"2020"},{"name":"year_end","type":"integer","desc":"裁判年份上界(含)","example":"2023"}],"hit_fields":[{"name":"case_no","desc":"案号"},{"name":"court_name","desc":"审理法院"},{"name":"cause_of_action","desc":"案由"},{"name":"case_type","desc":"案件类型"},{"name":"judgment_date","desc":"裁判日期"},{"name":"judgment_result","desc":"裁判结果"},{"name":"summary","desc":"案件摘要"},{"name":"applied_laws","desc":"引用法条(列表)"},{"name":"source","desc":"数据来源标识"},{"name":"score","desc":"召回相关度"}],"example_query":"民间借贷 利息"},{"domain":"legal","type":"law_article","status":"live","label":"法律法规条文","description":"检索中国现行法律法规条文(回源官方语料 + 语义召回)。","filters":[{"name":"law_name","type":"string","desc":"法律名称(精确/模糊)","example":"中华人民共和国民法典"},{"name":"law_level","type":"string","desc":"效力位阶:法律/行政法规/地方性法规/司法解释等","example":"法律"},{"name":"jurisdiction_scope","type":"string","desc":"适用地域:national/省名","example":"national"}],"hit_fields":[{"name":"law_name","desc":"所属法律名称"},{"name":"article_no","desc":"条号"},{"name":"content","desc":"条文正文"},{"name":"law_level","desc":"效力位阶"},{"name":"source_url","desc":"官方出处(可回溯)"}],"example_query":"合同解除 违约金"},{"domain":"legal","type":"law_catalog","status":"live","label":"法律法规目录","description":"按名称/位阶/地域检索法律法规(目录级)。","filters":[{"name":"law_name","type":"string","desc":"法律名称(精确/模糊)","example":"中华人民共和国民法典"},{"name":"law_level","type":"string","desc":"效力位阶:法律/行政法规/地方性法规/司法解释等","example":"法律"},{"name":"jurisdiction_scope","type":"string","desc":"适用地域:national/省名","example":"national"}],"hit_fields":[{"name":"law_name","desc":"所属法律名称"},{"name":"article_no","desc":"条号"},{"name":"content","desc":"条文正文"},{"name":"law_level","desc":"效力位阶"},{"name":"source_url","desc":"官方出处(可回溯)"}],"example_query":"劳动合同法"},{"domain":"content","type":"*","status":"planned","label":"内容","description":"内容数据域规划中,敬请期待。","filters":[],"hit_fields":[],"example_query":""},{"domain":"enterprise","type":"*","status":"planned","label":"企业","description":"企业数据域规划中,敬请期待。","filters":[],"hit_fields":[],"example_query":""},{"domain":"research","type":"*","status":"planned","label":"研究","description":"研究数据域规划中,敬请期待。","filters":[],"hit_fields":[],"example_query":""},{"domain":"cloud","type":"*","status":"planned","label":"云服务 API","description":"云服务 API数据域规划中,敬请期待。","filters":[],"hit_fields":[],"example_query":""}],"error_codes":[{"code":"unauthorized","http_status":401,"retryable":false,"next_action":"提供有效的 Authorization: Bearer devnors_sk_ 密钥（在 /console 创建）"},{"code":"insufficient_balance","http_status":402,"retryable":false,"next_action":"余额不足;充值入口 /console（充值后可重试）"},{"code":"invalid_capability","http_status":400,"retryable":false,"next_action":"domain/type 无效;可用组合见 /capabilities.json"},{"code":"rate_limited","http_status":429,"retryable":true,"next_action":"已限流;按响应头 Retry-After 秒退避后重试"},{"code":"not_implemented","http_status":501,"retryable":false,"next_action":"该数据域规划中;当前可用（live）域见 /capabilities.json"},{"code":"unavailable","http_status":503,"retryable":true,"next_action":"上游暂不可用;可短暂退避后重试"},{"code":"upstream_error","http_status":502,"retryable":true,"next_action":"数据检索失败，费用已退回;可重试"}],"pricing":{"docs_url":"https://data.devnors.com/console/pricing","unit":"按次调用计费，1 元 = 50000 tokens，按 units 计量；实时单价见 docs_url"},"machine_readable":{"capabilities":"https://data.devnors.com/capabilities.json","datasets":"https://data.devnors.com/datasets.json","data_sources":"https://data.devnors.com/data-sources.json","llms":"https://data.devnors.com/llms.txt","openapi":"https://data.devnors.com/openapi.json"},"sdk":{"python":"pip install devnors-data","mcp":"pip install devnors-mcp"}}