中国好律师 · API 接口文档

基于 Express 路由自动生成 · 覆盖全部业务模块

142接口总数
15业务模块
74GET 查询
68写入操作
ai.js /api/ai 35 端点

AI 助手（问答/文书/合同/检索/案源）

方法路径说明
POST /api/ai/chat ─── 1. AI 对话（SSE 流式）─────────────── POST /api/ai/chat body: { session_id?, messages: [{role,content}], type? }
POST /api/ai/search/cases ─── 2. 找类案 ──────────────────────────── POST /api/ai/search/cases body: { query, pageNo, pageSize, mode: semantic|keywo
POST /api/ai/search/laws ─── 3. 找法规 ──────────────────────────── POST /api/ai/search/laws body: { query, pageNo, pageSize, mode }
GET /api/ai/cases/:id ─── 4. 案例详情 ────────────────────────── GET /api/ai/cases/:id
GET /api/ai/laws/:id ─── 5. 法规详情 ────────────────────────── GET /api/ai/laws/:id
POST /api/ai/case/summarize ─── 5.1 AI 阅读裁判文书 ────────────────── POST /api/ai/case/summarize body: { title, content, cause?, court?, caseNumber? }
POST /api/ai/report/generate ─── 5.2 类案检索报告生成 ──────────────── POST /api/ai/report/generate body: { query, mode: 'case'|'law' } 检索 → AI 总结 → 结构化报告存库
GET /api/ai/report/:id GET /api/ai/report/:id 我的报告详情
GET /api/ai/report/:id/export GET /api/ai/report/:id/export?format=pdf|docx|html 报告导出（统一品牌模板）
POST /api/ai/doc/generate —
GET /api/ai/docs GET /api/ai/docs 我的文书列表
GET /api/ai/doc/types ─── 5.6 文书类型与 Schema ─────────────── GET /api/ai/doc/types 全部文书类型（含要素字段）
GET /api/ai/doc/schema/:type GET /api/ai/doc/schema/:type 单个文书 Schema
GET /api/ai/contract/templates ─── 5.7 合同生成 ───────────────────────── GET /api/ai/contract/templates 合同模板列表
POST /api/ai/contract/generate POST /api/ai/contract/generate 引导式合同生成 body: { type, style, description, special }
POST /api/ai/contract/review ─── 5.8 合同审查 ───────────────────────── POST /api/ai/contract/review body: { content, stance?, leverage? } 规则引擎兜底（免费毫秒级）
GET /api/ai/contract/reviews GET /api/ai/contract/reviews 我的审查历史
POST /api/ai/contract/review/batch POST /api/ai/contract/review/batch 多份合同批量审查 body: { items: [{name, content, stance?, leverage?}] }，最多 10 份 规则引擎全部跑（毫秒级）；
GET /api/ai/contract/reviews/:id/annotated GET /api/ai/contract/reviews/:id/annotated?format=pdf|docx 批注版导出（统一品牌模板） 从审查记录取原文+报告，生成带批注的 Word/PDF 文档
POST /api/ai/contract/compare ─── 5.9 合同比对 ───────────────────────── POST /api/ai/contract/compare body: { original, modified } 本地 diff（字符级）+ DeepSee
POST /api/ai/upload —
POST /api/ai/upload/batch POST /api/ai/upload/batch 批量上传解析（合同审查用，最多 10 个）
POST /api/ai/analyze —
GET /api/ai/analyzes GET /api/ai/analyzes 我的分析历史
GET /api/ai/analyze/:id/export GET /api/ai/analyze/:id/export?format=pdf|docx|html 文本分析报告导出（统一品牌模板）
POST /api/ai/analyze/timeline POST /api/ai/analyze/timeline 时间轴可视化（案件关键节点提取） body: { text } → 返回 { title, nodes:[{date,event,detail,type}] }
POST /api/ai/leads/manual POST /api/ai/leads/manual 手动创建案源（或从对话触发） body: { description, caseType?, city?, budget? }
GET /api/ai/leads GET /api/ai/leads 我的案源列表
GET /api/ai/leads/:id/matches GET /api/ai/leads/:id/matches 案源匹配的律师
POST /api/ai/leads/:id/refresh POST /api/ai/leads/:id/refresh 换一换（重新匹配）
GET /api/ai/sessions ─── 6. 会话管理 ────────────────────────── GET /api/ai/sessions 我的会话列表
GET /api/ai/sessions/:id/messages GET /api/ai/sessions/:id/messages 会话消息
DELETE /api/ai/sessions/:id DELETE /api/ai/sessions/:id 删除会话
GET /api/ai/sessions/:id/export ─── 6.5 会话导出（Word/PDF）─────────── GET /api/ai/sessions/:id/export?format=pdf|docx|html 会话导出（统一品牌模板） docx/PDF 直接下载文件（品牌模板
GET /api/ai/usage ─── 7. 用量查询 ────────────────────────── GET /api/ai/usage
alipay-webpay.js /api/pay/alipay 10 端点

支付宝 AI 网页应用收款

方法路径说明
GET /api/pay/alipay/config ─── 支付配置状态（前端显隐入口） ─────────
GET /api/pay/alipay/products ─── 商品目录（前端定价展示，实际支付以下单服务端校验为准） ─
POST /api/pay/alipay/create ─── 下单 ───────────────────────────────── body: { product_code } → 服务端按商品目录定价，返回支付 HTML 表单
GET /api/pay/alipay/query/:orderNo ─── 交易查询 ─────────────────────────────
GET /api/pay/alipay/orders ─── 我的订单列表 ─────────────────────────
GET /api/pay/alipay/entitlements ─── 我的权益 ─────────────────────────────
POST /api/pay/alipay/refund ─── 退款 ───────────────────────────────── body: { orderNo, refundAmount(元), reason? }
GET /api/pay/alipay/refund/query/:orderNo ─── 退款查询 ─────────────────────────────
POST /api/pay/alipay/close ─── 关闭交易（仅未支付订单） ─────────────
POST /api/pay/alipay/notify ─── 异步通知（支付宝 POST 表单） ───────── 验签 → 关键字段校验 → 幂等 → 状态更新 → 纯文本 success/fail
auth.js /api/auth 10 端点

认证与账号（注册/登录/短信/忘记密码）

方法路径说明
POST /api/auth/sms/send ─── 发送短信验证码 ────────────────────
POST /api/auth/sms/login ─── 验证码登录/注册（未注册自动注册） ──
POST /api/auth/sms/reset-password ─── 验证码重置密码 ────────────────────
POST /api/auth/register ─── 用户注册 ──────────────────────────────
POST /api/auth/login ─── 用户登录 ──────────────────────────────
GET /api/auth/me ─── 获取当前用户信息 ──────────────────────
PUT /api/auth/me ─── 更新当前用户信息 ──────────────────────
POST /api/auth/forgot-password ─── 忘记密码 - 申请重置（生成令牌） ────────
POST /api/auth/reset-password ─── 重置密码 ──────────────────────────────
PUT /api/auth/password ─── 修改密码（登录态） ─────────────────────
caseflow.js /api/caseflow 23 端点

智能委托（分类/委托/匹配/托管/结算/评价/排名）

方法路径说明
GET /api/caseflow/categories GET /api/caseflow/categories — 9 大领域树
GET /api/caseflow/me/lawyer GET /api/caseflow/me/lawyer — 当前用户关联的律师池档案（dashboard 专业设置用）
GET /api/caseflow/lawyer/specialties GET /api/caseflow/lawyer/specialties — 律师当前专业（?lawyer_id= 或 JWT）
PUT /api/caseflow/lawyer/specialties PUT /api/caseflow/lawyer/specialties — 律师即时修改专业（无审核） body: { lawyer_id, add: [category_id...], remove: [category_id...],
GET /api/caseflow/lawyer/specialties/history GET /api/caseflow/lawyer/specialties/history — 修改历史
POST /api/caseflow/case/initiate POST /api/caseflow/case/initiate — 提交案件（6步表单）→ 建委托 + 自动发布案源 body: { case_category_id, description, amount_range, provinc
POST /api/caseflow/lawyer/match POST /api/caseflow/lawyer/match — 提交案件ID，返回 3 位推荐律师 body: { entrust_id } 或 { case_category_id, province, city, amount_ra
POST /api/caseflow/consultation/start POST /api/caseflow/consultation/start — 发起免费咨询 body: { entrust_id, lawyer_id }
POST /api/caseflow/lawyer/switch POST /api/caseflow/lawyer/switch — 更换律师（≤3次） body: { entrust_id }
POST /api/caseflow/ai/transfer-to-lawyer POST /api/caseflow/ai/transfer-to-lawyer — AI 对话转真人 body: { session_id, case_category_id, description, city, amount_rang
GET /api/caseflow/ai/session/:id/summary GET /api/caseflow/ai/session/:id/summary — AI 对话摘要
POST /api/caseflow/contract/generate POST /api/caseflow/contract/generate — 生成委托书（草稿） body: { entrust_id }
POST /api/caseflow/contract/sign POST /api/caseflow/contract/sign — 电子签署（验证码确认 + 手写签名图） body: { contract_id, role: 'client'|'lawyer', signature_data }
GET /api/caseflow/contract/download/:id GET /api/caseflow/contract/download/:id — 下载委托书（返回文本）
POST /api/caseflow/payment/escrow/create POST /api/caseflow/payment/escrow/create — 创建托管账户（委托书双方签署后） body: { entrust_id, total_amount（元） }
POST /api/caseflow/payment/escrow/release POST /api/caseflow/payment/escrow/release — 释放节点资金 body: { escrow_id, node: 1|2|3 }
GET /api/caseflow/payment/escrow/status/:id GET /api/caseflow/payment/escrow/status/:id — 查询托管状态
POST /api/caseflow/payment/settle POST /api/caseflow/payment/settle — 结案确认 → 生成结算单（T+7） body: { escrow_id }
GET /api/caseflow/payment/settle/status/:id GET /api/caseflow/payment/settle/status/:id — 查询结算状态
POST /api/caseflow/review/submit POST /api/caseflow/review/submit — 结案后 5 维评价 body: { lawyer_id, entrust_id, score_professional, score_communication, sco
GET /api/caseflow/review/lawyer/:id GET /api/caseflow/review/lawyer/:id — 律师评价汇总（5 维）
POST /api/caseflow/ranking/recalc —
GET /api/caseflow/lawyer/ranking GET /api/caseflow/lawyer/ranking — 获取排名列表
company.js /api/company 4 端点

企业法律风险查询（元典）

方法路径说明
GET /api/company/search ═══ 1. 企业检索（名称关键词 → 候选列表）═══ GET /api/company/search?name=百度&top_k=10
GET /api/company/overview ═══ 2. 企业风险总览（聚合统计 + 基本信息 + 涉诉统计，一次返回）═══ GET /api/company/overview?id=xxx
GET /api/company/writs ═══ 3. 企业涉诉文书列表（分页）═══ GET /api/company/writs?id=xxx&pageNo=1
GET /api/company/status ═══ 4. 健康检查（前端用来判断是否已配置 Key）═══ GET /api/company/status
export-kit.js /api/export 2 端点

统一导出引擎（品牌 PDF/Word）

方法路径说明
POST /api/export/kit format: 'pdf' | 'docx', contentType: 'text' | 'html' | 'qa', content: '文本' | { html } | { messages: [{role, content}] },
GET /api/export/health GET /api/export/health —— 渲染引擎健康检查
firm-detail.js /api/verify 3 端点

律所详情与评价

方法路径说明
GET /api/verify/firms/detail/:id ═══ 律所详情 ═══
PUT /api/verify/firms/:id/areas ═══ 专长维护（仅该律所绑定/认证用户可改） ═══
GET /api/verify/firms/detail/:id/cases ═══ 得理案例分页（律所详情“更多”）═══
geo.js /api/geo 1 端点

地理定位（IP 城市级/坐标本地计算）

方法路径说明
GET /api/geo/locate —
lawyer-detail.js /api/verify 5 端点

律师详情与评价聚合

方法路径说明
GET /api/verify/lawyers/detail/:id ═══ 律师详情 ═══
GET /api/verify/lawyers/detail/:id/cases ═══ 得理案例分页（律师详情“更多”）═══
POST /api/verify/lawyers/detail/:id/reviews —
GET /api/verify/lawyers/detail/:id/reviews ═══ 评价：分页列表（公开）═══ GET /api/verify/lawyers/detail/:id/reviews?page=1&limit=10
GET /api/verify/reviews/recent ═══ 评价：全站最近评价（公开，首页/列表嵌入 G3c）═══ GET /api/verify/reviews/recent?limit=6
leads.js /api/leads 6 端点

案源市场（评分/浏览/解锁/认领）

方法路径说明
POST /api/leads/score ─── 1. 案源发布 + AI 评分（当事人免费，限免）──── POST /api/leads/score
GET /api/leads/market ─── 2. 案源市场列表（律师 · 基础版门槛）──── GET /api/leads/market?tier=&city=&case_type=&page=&pageSize=
GET /api/leads/market/:id/preview ─── 3. 评分明细预览（律师 · 基础版门槛）──── GET /api/leads/market/:id/preview
POST /api/leads/market/:id/unlock ─── 4. 解锁联系方式（律师 · 专业版门槛，不独占）──── POST /api/leads/market/:id/unlock
POST /api/leads/market/:id/claim ─── 5. 独家认领（律师 · 企业版门槛，案源下架）──── ⚠️ 【已停用 2026-08-14】案源下架功能暂不需要，路由注销但代码完整保留，恢复时取消注释即可 POST /api/leads/market/:id/claim
GET /api/leads/my-claims ─── 6. 我认领/解锁的案源（律师）──── GET /api/leads/my-claims
me.js /api/me 12 端点

个人中心（通知/收藏/委托/看板/团队）

方法路径说明
GET /api/me/notifications ─── 1. 通知中心 ─────────────────────────── GET /api/me/notifications?limit=20&unread=1
PUT /api/me/notifications/:id/read PUT /api/me/notifications/:id/read
PUT /api/me/notifications/read-all PUT /api/me/notifications/read-all
POST /api/me/favorites ─── 2. 收藏 ─────────────────────────────── POST /api/me/favorites body: { target_type, target_id }
GET /api/me/favorites GET /api/me/favorites?type=lawyer （含名称信息）
DELETE /api/me/favorites/:type/:id DELETE /api/me/favorites/:type/:id
POST /api/me/entrustments ─── 3. 委托中心 ─────────────────────────── POST /api/me/entrustments body: { lawyer_id, case_type, description, budget }
GET /api/me/entrustments GET /api/me/entrustments （当事人视角：我发起的；律师视角：发给我的）
PUT /api/me/entrustments/:id/status PUT /api/me/entrustments/:id/status body: { status } 当事人: cancel；律师: accept | reject | close
GET /api/me/profile-score ─── 4. 律师档案完善度 ───────────────────── GET /api/me/profile-score
GET /api/me/stats ─── 5. 数据看板（真实统计） ─────────────── GET /api/me/stats
GET /api/me/team ─── 6. 主任后台：团队管理 ───────────────── GET /api/me/team
submissions.js /api/submissions 8 端点

知识文章投稿与公开列表

方法路径说明
POST /api/submissions/ ─── 创建投稿 / 保存草稿 ──────────────────
GET /api/submissions/public ─── 公开接口：已发布文章列表（法律知识页） ──
GET /api/submissions/public/:id ─── 公开接口：已发布文章详情（文章页） ────
GET /api/submissions/my ─── 我的投稿列表 ─────────────────────────
GET /api/submissions/:id ─── 投稿详情 ─────────────────────────────
PUT /api/submissions/:id ─── 更新投稿（仅草稿/退回状态可编辑） ────
POST /api/submissions/:id/submit ─── 提交审核（从草稿→待审） ──────────────
DELETE /api/submissions/:id ─── 删除投稿（仅草稿可删） ────────────────
support.js /api/support 2 端点

智能客服（网站问题解答）

方法路径说明
POST /api/support/chat POST /api/support/chat body: { message: string } 返回: { reply, quick: true(知识库命中)|false(AI生成), topic? }
GET /api/support/health 健康检查：知识库条数
verify.js /api/verify 16 端点

律师/律所数据池检索与平台统计

方法路径说明
POST /api/verify/lawyer ═══ 律师入驻提交 ═══
POST /api/verify/firm ═══ 律所入驻提交 ═══
GET /api/verify/my-status ═══ 查询我的入驻状态 ═══
GET /api/verify/admin/list ═══ 管理员审核：获取待审列表 ═══
POST /api/verify/admin/review ═══ 管理员审核：通过/驳回 ═══
GET /api/verify/lawyers/list ═══ 公开接口：已审核律师列表 ═══
GET /api/verify/firms/list ═══ 公开接口：已审核律所列表 ═══
PUT /api/verify/lawyer/profile ═══ 已入驻律师编辑个人信息 ═══
GET /api/verify/invite/:type/:id ═══ 生成邀请链接 ═══
GET /api/verify/lawyers/pool ═══ 公开接口：基础数据池（含注册状态） ═══
GET /api/verify/lawyers/city-top ═══ 城市推荐律师（首页城市面板用）：已注册认证律师优先，律师池兜底 ═══
POST /api/verify/admin/verify ═══ 身份核验：比对律师池数据 ═══
POST /api/verify/admin/import ═══ 数据导入：批量写入律师池 ═══
GET /api/verify/firms/pool ═══ 公开接口：律所基础数据池 ═══
GET /api/verify/stats ═══ 公开接口：平台统计（首页动态数据） ═══
GET /api/verify/cities ═══ 公开接口：某省的城市列表（筛选联动用，合并律师+律所） ═══
wechat.js /api/wechat 5 端点

微信扫码登录

方法路径说明
GET /api/wechat/config ─── 获取扫码登录配置（前端控制入口显隐） ──
POST /api/wechat/qrcode ─── 创建扫码会话 ──────────────────────
GET /api/wechat/poll ─── 轮询扫码状态 ──────────────────────
GET /api/wechat/callback ─── 微信回调（code 换 token + 登录/绑定） ──
POST /api/wechat/bind-phone ─── 绑定手机号（微信登录后补充手机号） ── 需要验证码（purpose=login 复用）；绑定成功后手机号成为正式登录凭证
中国好律师 API · 自动生成于 2026-08-19 · 更新后请重新运行 node scripts/api-doc-gen.js