{
  "user_id": "10086",
  "nickname": "张三",
  "expires_in": 86400
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 86400,
  "registered": false,
  "user": {
    "id": 42,
    "username": "ext_erpsap_10086",
    "external_user_id": "10086",
    "is_active": true,
    "is_frozen": false
  }
}

import requests

BASE = "http://localhost:8000"

# 1. 换取用户凭证(组织 Key → 用户 JWT)
r = requests.post(f"{BASE}/api/v1/token",
    headers={"Authorization": "Bearer djk_<组织Key>"},
    json={"user_id": "10086"})
token = r.json()["token"]

# 2. 换证
r = requests.post(f"{BASE}/api/v1/token",
    headers={"Authorization": f"Bearer {token}"}
    json={}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 签发用户凭证
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/v1/token"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer djk_<组织Key>")
                .POST(HttpRequest.BodyPublishers.ofString({"user_id": "10086"}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 换取用户凭证(组织 Key → 用户 JWT)
const r = await fetch(`${BASE}/api/v1/token`, {
  method: 'POST',
  headers: { Authorization: 'Bearer djk_<组织Key>', 'Content-Type': 'application/json' },
  body: JSON.stringify({ user_id: '10086' })
});
const { token } = await r.json();

// 签发用户凭证
const resp = await fetch(`${BASE}/api/v1/token`, {
  method: 'POST',
  headers: { Authorization: 'Bearer djk_<组织Key>', 'Content-Type': 'application/json' },
  body: JSON.stringify({"user_id": "10086"})
});
console.log(resp.status);
console.log(await resp.json());

{
  "user_id": "10086",
  "email": "zhangsan@corp.com",
  "quota": 50
}

{
  "success": true,
  "id": 42,
  "username": "ext_erpsap_10086"
}

import requests

BASE = "http://localhost:8000"

# 2. 预创建用户
r = requests.post(f"{BASE}/api/v1/users",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"user_id": "10086", "quota": 50}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 预创建用户
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/v1/users"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer djk_<组织Key>")
                .POST(HttpRequest.BodyPublishers.ofString({"user_id": "10086", "quota": 50}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 换取用户凭证(组织 Key → 用户 JWT)
const r = await fetch(`${BASE}/api/v1/token`, {
  method: 'POST',
  headers: { Authorization: 'Bearer djk_<组织Key>', 'Content-Type': 'application/json' },
  body: JSON.stringify({ user_id: '10086' })
});
const { token } = await r.json();

// 预创建用户
const resp = await fetch(`${BASE}/api/v1/users`, {
  method: 'POST',
  headers: { Authorization: 'Bearer djk_<组织Key>', 'Content-Type': 'application/json' },
  body: JSON.stringify({"user_id": "10086", "quota": 50})
});
console.log(resp.status);
console.log(await resp.json());

(multipart/form-data)
files=@合同.docx
contract_type_code=sale
stance=party_a
intensity=standard

{
  "tasks": [
    { "task_id": "a1b2c3d4e5", "file_id": "f123", "file_name": "采购合同.docx" }
  ]
}

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/tasks/submit",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/tasks/submit`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

GET /api/tasks/a1b2c3d4e5/status

{
  "task_id": "a1b2c3d4e5",
  "status": "running",
  "progress": 50.0,
  "message": "正在进行AI审核...",
  "result": null,
  "error": null
}

import requests

BASE = "http://localhost:8000"

# 2. 查询任务状态
r = requests.post(f"{BASE}/api/tasks/a1b2c3d4e5/status",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 查询任务状态
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/tasks/a1b2c3d4e5/status"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 查询任务状态
const resp = await fetch(`${BASE}/api/tasks/a1b2c3d4e5/status`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({})
});
console.log(resp.status);
console.log(await resp.json());

{
  "id": 1, "file_id": "f123", "file_name": "采购合同.docx",
  "contract_type_code": "purchase", "stance": "party_a", "intensity": "standard",
  "status": "completed", "score": 85.0,
  "total_issues": 5, "high_risk_count": 1, "medium_risk_count": 2, "low_risk_count": 2,
  "audit_result": {
    "issues": [
      { "issue_type": "条款缺失", "severity": "high",
        "location": "第4条", "suggestion": "建议补充违约责任条款" }
    ],
    "summary": "整体合同质量良好,存在 1 项高风险问题..."
  },
  "extracted_fields": { "合同金额": "100万", "甲方": "XX公司" },
  "created_at": "2026-08-10T10:00:00", "completed_at": "2026-08-10T10:30:00"
}

(multipart/form-data)
file=@合同v1.pdf
role=source

{ "file_id": "abc123def456", "file_name": "合同v1.pdf", "size_bytes": 123456, "role": "source" }

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/doc-compare/upload",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/doc-compare/upload`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{ "task_id": "compare:ab12cd34", "status": "queued", "message": "比对任务已提交" }

{
  "success": true,
  "data": {
    "page_diffs": [
      { "page": 1, "type": "modified",
        "content_before": "甲方: XX公司", "content_after": "甲方: YY公司" }
    ],
    "stat": { "added": 2, "deleted": 1, "modified": 5 }
  }
}

import requests

BASE = "http://localhost:8000"

# 2. 获取比对结果
r = requests.post(f"{BASE}/api/doc-compare/compare:ab12cd34/result",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 获取比对结果
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/doc-compare/compare:ab12cd34/result"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 获取比对结果
const resp = await fetch(`${BASE}/api/doc-compare/compare:ab12cd34/result`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({})
});
console.log(resp.status);
console.log(await resp.json());

(multipart/form-data)
file=@发票.pdf

{ "file_id": "a1b2c3d4e5f6", "file_name": "发票.pdf", "size_bytes": 20480 }

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/uploads/quick",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/uploads/quick`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{
  "templates": [
    { "id": 1, "code": "contract_elements", "name": "合同要素", "is_default": true,
      "fields": [
        { "key": "party_a", "label": "甲方", "type": "text" },
        { "key": "amount", "label": "合同金额", "type": "money" }
      ] }
  ]
}

(multipart/form-data)
file_id=a1b2c3d4e5f6
template_id=1
mode=standard

{ "task_id": "extract:a1b2c3d4e5f6:abc12345", "status": "pending", "message": "提取任务已提交" }

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/extractions/quick",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/extractions/quick`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{
  "status": "completed", "progress": 100.0, "message": "提取完成",
  "fields": { "甲方": "XX公司", "乙方": "YY公司", "合同金额": "100万元", "签订日期": "2026年8月10日" },
  "error": null
}

{ "name": "产品知识库", "description": "产品手册与FAQ", "kb_type": "text" }

{ "success": true, "id": 3, "data": { "id": 3, "name": "产品知识库", "kb_type": "text",
  "document_count": 0, "chunk_count": 0, "status": "active" } }

import requests

BASE = "http://localhost:8000"

# 2. 创建知识库
r = requests.post(f"{BASE}/api/kb",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"name": "产品知识库", "kb_type": "text"}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 创建知识库
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/kb"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"name": "产品知识库", "kb_type": "text"}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 创建知识库
const resp = await fetch(`${BASE}/api/kb`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"name": "产品知识库", "kb_type": "text"})
});
console.log(resp.status);
console.log(await resp.json());

(multipart/form-data)
files=@手册.pdf
files=@FAQ.docx

{ "success": true, "created": [ { "doc_id": "abc123hex16", "file_name": "手册.pdf", "file_format": "pdf", "status": "pending" } ], "failed": [] }

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/kb/3/documents",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/kb/3/documents`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{
  "query": "退货运费谁承担",
  "kb_ids": [3],
  "top_k": 5
}

{
  "success": true,
  "answer": "根据《退货政策》第2条,退货运费由买方承担,但若因商品质量问题导致退货,运费由卖方承担。",
  "chunks": [ { "kb_id": 3, "kb_name": "产品知识库", "doc_id": "abc123", "chunk_id": "chunk_01",
                "score": 0.92, "content": "第2条 退货运费...", "page": 3 } ],
  "routed_kbs": [ { "kb_id": 3, "kb_name": "产品知识库", "score": 0.9 } ]
}

import requests

BASE = "http://localhost:8000"

# 2. 知识库检索
r = requests.post(f"{BASE}/api/kb/search",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"query": "退货运费谁承担", "top_k": 5}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 知识库检索
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/kb/search"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"query": "退货运费谁承担", "top_k": 5}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 知识库检索
const resp = await fetch(`${BASE}/api/kb/search`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"query": "退货运费谁承担", "top_k": 5})
});
console.log(resp.status);
console.log(await resp.json());

{
  "code": 1000, "msg": "识别成功", "responseTime": 1780367412316,
  "requestCostTime": 1.08, "cacheUsed": false, "logId": "094bd90b-...",
  "data": {
    "totalImages": 1, "modelType": "ppocrv5-server",
    "results": [ { "imageIndex": 1, "fileName": "document.png", "width": 1524, "height": 1368,
      "rotateAngle": 0, "textCount": 42,
      "ocrResult": [ { "text": "识别文本", "confidence": 0.95,
                       "box": [[100,50],[300,50],[300,100],[100,100]] } ],
      "fullText": "全文拼接文本" } ]
  }
}

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"
r = requests.post(f"{BASE}/api/v3/ocr/image",
    headers={"Authorization": f"Bearer {token}"},
    files={"files": ("document.png", open("document.png", "rb"))},
    data={"include_coordinates": "true"})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("files", file);
fd.append("include_coordinates", "true");
const resp = await fetch(`${BASE}/api/v3/ocr/image`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{
  "object": "list",
  "data": [
    { "id": "deepseek-v4-pro", "object": "model", "owned_by": "deepseek", "active": true },
    { "id": "qwen2.5-72b", "object": "model", "owned_by": "vllm", "active": false }
  ]
}

import requests

BASE = "http://localhost:8000"

# 2. 获取模型列表
r = requests.post(f"{BASE}/llm/v1/models",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 获取模型列表
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/llm/v1/models"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 获取模型列表
const resp = await fetch(`${BASE}/llm/v1/models`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({})
});
console.log(resp.status);
console.log(await resp.json());

{
  "model": "deepseek-v4-pro",
  "messages": [ { "role": "user", "content": "退货运费谁承担?" } ],
  "kb_ids": [3],
  "kb_top_k": 5
}

{
  "id": "chatcmpl-abc123", "object": "chat.completion", "created": 1780367412,
  "model": "deepseek-v4-pro",
  "choices": [ { "index": 0, "message": { "role": "assistant",
    "content": "根据《退货政策》第2条,退货运费由买方承担..." }, "finish_reason": "stop" } ],
  "usage": { "prompt_tokens": 1200, "completion_tokens": 150, "total_tokens": 1350 }
}

import requests

BASE = "http://localhost:8000"

# 2. LLM 对话补全(挂载知识库)
r = requests.post(f"{BASE}/llm/v1/chat/completions",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"model": "deepseek-v4-pro", "messages": [{"role": "user", "content": "退货运费谁承担?"}], "kb_ids": [3]}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // LLM 对话补全(挂载知识库)
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/llm/v1/chat/completions"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"model": "deepseek-v4-pro", "messages": [{"role": "user", "content": "退货运费谁承担?"}], "kb_ids": [3]}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// LLM 对话补全(挂载知识库)
const resp = await fetch(`${BASE}/llm/v1/chat/completions`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"model": "deepseek-v4-pro", "messages": [{"role": "user", "content": "退货运费谁承担?"}], "kb_ids": [3]})
});
console.log(resp.status);
console.log(await resp.json());

(multipart/form-data)
file=@判决书.pdf

{ "file_id": "a1b2c3d4e5f6", "file_name": "判决书.pdf", "size_bytes": 1048576 }

import requests

BASE = "http://localhost:8000"
token = "<用户JWT>"  # POST /api/v1/token 换取
r = requests.post(f"{BASE}/api/redact/upload",
    headers={"Authorization": f"Bearer {token}"},
    files={"file": open("文件.pdf", "rb")},
    data={})
print(r.status_code, r.json())

const BASE = 'http://localhost:8000';
const fd = new FormData();
fd.append("file", file);  // 前端文件对象
const resp = await fetch(`${BASE}/api/redact/upload`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body: fd
});
console.log(await resp.json());

{ "file_id": "a1b2c3d4e5f6", "profile": "contract", "detect_seals": true }

{ "task_id": "redact:a1b2c3d4e5f6:ab12cd34", "status": "scanning", "message": "正在侦测敏感项..." }

import requests

BASE = "http://localhost:8000"

# 2. 触发敏感项侦测
r = requests.post(f"{BASE}/api/redact/scan",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"file_id": "a1b2c3d4e5f6", "profile": "contract"}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 触发敏感项侦测
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/redact/scan"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"file_id": "a1b2c3d4e5f6", "profile": "contract"}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 触发敏感项侦测
const resp = await fetch(`${BASE}/api/redact/scan`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"file_id": "a1b2c3d4e5f6", "profile": "contract"})
});
console.log(resp.status);
console.log(await resp.json());

{
  "task_id": "redact:...", "status": "reviewing", "profile": "contract",
  "scan_result": {
    "涉案人/相关人员": [
      { "field": "身份证号", "text": "110101199001011234", "page": 1, "confidence": 0.98 } ],
    "涉案单位/签约主体": [
      { "field": "公司名称", "text": "XX科技有限公司", "page": 1, "confidence": 0.9 } ]
  }
}

{ "task_id": "redact:...", "blacklist": ["客户简称"], "whitelist": ["姓名"], "date_mode": "quarter" }

{ "task_id": "redact:...", "status": "applying", "message": "正在生成脱敏副本..." }

import requests

BASE = "http://localhost:8000"

# 2. 应用脱敏
r = requests.post(f"{BASE}/api/redact/apply",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"task_id": "redact:xxx"}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 应用脱敏
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/redact/apply"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <用户JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"task_id": "redact:xxx"}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 应用脱敏
const resp = await fetch(`${BASE}/api/redact/apply`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"task_id": "redact:xxx"})
});
console.log(resp.status);
console.log(await resp.json());

{
  "task_id": "redact:...", "status": "completed", "progress": 100.0,
  "message": "脱敏副本生成完成",
  "verify_result": { "total": 12, "remaining": 0 },
  "error": null
}

{ "user_id": "10086", "expires_in": 300, "scope": "page" }

{
  "code": 1000,
  "msg": "success",
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "token_type": "bearer",
    "expires_in": 300,
    "scope": "page",
    "user": { "user_id": "10086", "registered": true }
  }
}

# 1. 组织 Key 换短时效页面凭证(300 秒,仅 page)
curl -X POST https://<host>/api/v1/token \
  -H "Authorization: Bearer djk_xxx" -H "Content-Type: application/json" \
  -d '{"user_id":"10086","expires_in":300,"scope":"page"}'

# 2. 浏览器跳转(Referer 需在组织 domain_whitelist 内,若组织配置了白名单)
https://<host>/sso/enter?token=<JWT>&redirect=/tasks

https://<host>/sso/enter?token=dkp_xxx&redirect=/tasks

{
  "success": true,
  "data": {
    "task_id": "sealverify:670c9fbddb4d:c27b9a02",
    "file_id": "670c9fbddb4d",
    "file_name": "订单类合同.pdf",
    "file_kind": "pdf",
    "status": "pending",
    "progress": 0,
    "phase": null,
    "message": null,
    "total_pages": 0,
    "candidate_pages": [],
    "seal_count": 0,
    "duration_ms": null,
    "llm_enhanced": false,
    "error_message": null,
    "created_at": "2026-09-01T06:11:40",
    "completed_at": null
  }
}

# 组织 Key 直连:上传并创建任务(自动注册/映射归属用户)
curl -X POST https://<host>/api/v1/seal-verifications \
  -H "Authorization: Bearer djk_xxx" \
  -F "file=@订单类合同.pdf" \
  -F "user_id=10086"

{
  "success": true,
  "data": {
    "task_id": "sealverify:670c9fbddb4d:c27b9a02",
    "status": "completed",
    "progress": 100,
    "phase": "done",
    "total_pages": 1,
    "candidate_pages": [1],
    "seal_count": 2,
    "duration_ms": 12900,
    "llm_enhanced": true,
    "result": {
      "pages": [
        {
          "page": 1,
          "width": 595,
          "height": 842,
          "seals": [
            {
              "index": 1,
              "page": 1,
              "text": "示例网络科技有限公司 合同专用章",
              "kind": "full",
              "norm": [0.62, 0.66, 0.93, 0.87],
              "image": "seals/1.png",
              "width": 352,
              "height": 347,
              "ring_text": "示例网络科技有限公司",
              "horizontal_text": "合同专用章",
              "code": "2431846",
              "calibrated_name": "示例网络科技有限公司合同专用章",
              "seal_type": "合同专用章",
              "corrected": false,
              "match_status": "与甲方匹配",
              "match_code": "match_party_a",
              "matched_party": "示例网络科技有限公司"
            }
          ]
        }
      ],
      "llm": {
        "enhanced": true,
        "parties": [
          { "role": "甲方", "name": "示例网络科技有限公司" },
          { "role": "乙方", "name": "某某信息技术有限公司" }
        ],
        "error": null
      },
      "fallback_pages": [],
      "failed_pages": [],
      "raw_pages": { }
    }
  }
}

{
  "success": true,
  "data": {
    "tasks": [ { "task_id": "sealverify:...", "file_name": "合同.pdf", "status": "completed", "seal_count": 2 } ],
    "total": 1, "page": 1, "per_page": 10, "pages": 1
  }
}

{ "success": true, "data": { "task_id": "sealverify:670c9fbddb4d:c27b9a02" } }

# 用户 JWT 通道:轮询结果 + 下载第 1 枚印章裁剪图
curl -H "Authorization: Bearer <用户JWT>" \
  https://<host>/api/v1/seal-verifications/sealverify:670c9fbddb4d:c27b9a02
curl -H "Authorization: Bearer <用户JWT>" \
  https://<host>/api/v1/seal-verifications/sealverify:670c9fbddb4d:c27b9a02/seals/1/image \
  --output seal_1.png

{
  "success": true,
  "data": {
    "tasks": [
      { "task_id": "njca:670c9fbddb4d:1a2b3c4d", "file_name": "授权委托书.jpg", "file_kind": "image", "status": "pending", "progress": 0 }
    ],
    "skipped": []
  }
}

{
  "success": true,
  "data": {
    "task_id": "njca:670c9fbddb4d:1a2b3c4d",
    "status": "completed",
    "conclusion": "通过",
    "fail_reasons": [],
    "duration_ms": 5125,
    "fields": {
      "authorized_name": "史笑艳",
      "id_number": "320107199003150027",
      "id_valid": true,
      "entrust_unit": "南京数字认证有限公司",
      "legal_person": "孙高健",
      "business_items": ["新办"],
      "seal_found": true,
      "seal_names": ["南京数字认证有限公司合同专用章"],
      "seal_match": true,
      "warnings": []
    },
    "result": {
      "pages": [ { "page": 1, "width": 1190, "height": 1680, "seal_count": 1 } ],
      "seals": [ { "index": 1, "page": 1, "text": "南京数字认证有限公司...", "norm": [0.6, 0.68, 0.95, 0.92], "image": "seals/1.png" } ],
      "llm": { "enhanced": true, "error": null }
    }
  }
}

# 组织 Key 批量创建
curl -X POST https://<host>/api/v1/njca-audits   -H "Authorization: Bearer djk_xxx"   -F "files=@委托书1.jpg" -F "files=@委托书2.pdf"   -F "user_id=10086"

# 轮询结论
curl -H "Authorization: Bearer djk_xxx"   https://<host>/api/v1/njca-audits/njca:670c9fbddb4d:1a2b3c4d

{ "code": "erp-sap", "name": "SAP ERP", "auto_register": true, "domain_whitelist": ["erp.example.com"] }

{ "success": true, "id": 1, "data": { "id": 1, "code": "erp-sap", "name": "SAP ERP", "auto_register": true, "status": 1 } }

import requests

BASE = "http://localhost:8000"

# 2. 创建外部系统
r = requests.post(f"{BASE}/api/admin/external-systems",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
    json={"code": "erp-sap", "name": "SAP ERP", "auto_register": true}
print(r.status_code)
print(r.json())

import java.net.URI;
import java.net.http.*;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // 创建外部系统
        HttpRequest req = HttpRequest.newBuilder(
                URI.create("http://localhost:8000/api/admin/external-systems"))
                .header("Content-Type", "application/json")
.header("Authorization", "Bearer <管理员JWT>")
                .POST(HttpRequest.BodyPublishers.ofString({"code": "erp-sap", "name": "SAP ERP", "auto_register": true}))
                .build();

        HttpResponse<String> resp = client.send(req,
                HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode());
        System.out.println(resp.body());
    }
}

const BASE = 'http://localhost:8000';

// 创建外部系统
const resp = await fetch(`${BASE}/api/admin/external-systems`, {
  method: 'POST',
  headers: { Authorization: 'Bearer <管理员JWT>', 'Content-Type': 'application/json' },
  body: JSON.stringify({"code": "erp-sap", "name": "SAP ERP", "auto_register": true})
});
console.log(resp.status);
console.log(await resp.json());

{ "name": "ERP 生产环境", "external_system_id": 1,
  "permissions": ["users","audit","extract","kb"], "expires_at": "2027-12-31T00:00:00" }

{ "success": true, "key": "djk_ab12cd34.xxxxx", "data": { "id": 1, "api_id": "ab12cd34",
  "name": "ERP 生产环境", "key_preview": "djk_ab12***", "status": 1 } }

# pip install "mcp>=1.20.0,<2"
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

DJWORK_URL = "https://your-host/mcp/djwork/"
JWT = "<用户 JWT>"   # §二 组织 Key 换证获得

async def main():
    async with streamablehttp_client(
        DJWORK_URL, headers={"Authorization": f"Bearer {JWT}"}
    ) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()

            # 1) REST 上传文件后（拿到 file_id）提交印章核验
            res = await session.call_tool(
                "seal_verify_start", {"file_id": "<file_id>"}
            )
            task_id = __import__("json").loads(res.content[0].text)["task_id"]

            # 2) 轮询结果（扫描件通常 1~5 分钟）
            import json, time
            while True:
                r = await session.call_tool(
                    "seal_verify_status", {"task_id": task_id}
                )
                task = json.loads(r.content[0].text)["task"]
                if task["status"] in ("completed", "failed", "cancelled"):
                    print(json.dumps(task, ensure_ascii=False, indent=2))
                    break
                time.sleep(10)

asyncio.run(main())

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "kb_search", "arguments": {
    "query": "试用期解除劳动合同的条件",
    "kb_names": ["劳动法规件"],
    "top_k": 5
  }}
}

{
  "success": true,
  "data": {
    "id": 12,
    "title": "项目周会录音",
    "status": "ready",
    "has_audio": true,
    "audio_duration": 634.5,
    "transcript": "……",
    "corrected_text": null,
    "summary": null,
    "mindmap": null,
    "segments": [{"s": 0.0, "e": 3.2, "text": "大家好，今天过一下项目进度"}],
    "audio_url": "/api/notes/12/audio",
    "updated_at": "2026-09-09T08:00:00"
  }
}

{ "success": true, "data": { "sample_count": 6, "liveness_score": 1.0, "quality_score": 1.0 } }

# Python 集成示例：录入 + 1:1 验证
import requests

BASE = "https://djwork.njca.com.cn"
KEY = "djk_xxx"

# 1. 录入（多帧）
requests.post(f"{BASE}/api/v1/face/enroll",
    headers={"X-API-Key": KEY},
    data={"user_id": "emp-1001"},
    files=[("frames", open("f1.jpg", "rb")), ("frames", open("f2.jpg", "rb"))])

# 2. 1:N 检索
r = requests.post(f"{BASE}/api/v1/face/search",
    headers={"X-API-Key": KEY},
    files={"frame": open("query.jpg", "rb")}).json()
print(r["data"])  # {'matched': True, 'user_id': 'emp-1001', 'similarity': 0.93, ...}

POST /api/admin/agent/chat
Authorization: Bearer <ADMIN_JWT>
Content-Type: application/json
Accept: text/event-stream

{
  "session_id": "<POST /sessions 返回的 UUID>",
  "model_id": "system:1",
  "messages": [{"role": "user", "content": "查询近7天的全局Token用量"}],
  "context": {"tab": "overview"}
}

event: delta
data: {"content":"已查询实际统计，正在整理结果。"}

event: done
data: {}

{
  "session_id": "<事件中的session_id>",
  "turn_id": "<事件中的turn_id>",
  "action_id": "<事件中的action_id>",
  "approved": false
}

{
  "session_id": "<事件中的session_id>",
  "turn_id": "<事件中的turn_id>",
  "question_id": "<事件中的question_id>",
  "selected_option_ids": ["<当前options中的id>"],
  "other_text": "",
  "cancelled": false
}