病历脱敏

EasyDoc 提供专业的病历文档智能脱敏服务，可精准识别并自动遮蔽敏感信息（如患者姓名、身份证号、联系电话等），保障医疗数据在共享、归档、训练等场景下的数据安全与合规性。支持结构化规则与自动识别双模式，通过异步接口返回结果，助力企业实现高效、安全的非结构化数据治理。

接口概览

属性	说明
接口名称	文档智能脱敏处理（异步）
请求方法	`POST`
请求地址	`https://api.easylink-ai.com/v1/easydoc/mask`
内容类型	`multipart/form-data`
响应格式	`application/json`
调用模式	异步处理，返回任务 ID，结果通过轮询获取

请求头（Headers）

Header 名称	类型	必填	说明
`api-key`	string	是	认证密钥，由平台分配。例如：`api-key: your_apikey_here`

请求参数（Form-Data）

参数名	类型	必填	默认值	说明
`files`	file 或 file[]	是	-	待脱敏文件，JPG/PNG/BMP/TIFF/PDF
`mode`	enum(string)	是	-	计费模式：`emr-mask`

json_schema 示例（固定字段）

{
            "患者姓名": {"type": "string"},
            "患者性别": {"type": "string"},
            "入院时间": {"type": "string"},
            "出院时间": {"type": "string"},
            "年龄": {"type": "string"},
            "住院时长": {"type": "string"}
        }

脱敏请求示例（结构化脱敏）

curl -X POST "https://api.easylink-ai.com/v1/easydoc/mask" \
  -H "api-key: your_apikey_here" \
  -F "files=@medical_record_001.pdf" \
  -F 'json_schema={
    "type": "object",
    "properties": {
            "患者姓名": {"type": "string"},
            "患者性别": {"type": "string"},
            "入院时间": {"type": "string"},
            "出院时间": {"type": "string"},
            "年龄": {"type": "string"},
            "住院时长": {"type": "string"}
        }
  }' \
  -F "mode=emr-mask"

响应结构（异步）

任务提交成功

{
  "success": true,
  "data": {
    "task_id": "r_mask_9876543210",
    "status": "PROCESSING"
  }
}

轮询检查任务状态

curl -X GET "https://api.easylink-ai.com/v1/easydoc/mask/{task_id}" \
  -H "api-key: your_apikey_here"

请将 {task_id} 替换为实际任务 ID。

最终结果示例

{
  "success": true,
  "data": {
    "task_id": "r_mask_9876543210",
    "status": "SUCCESS",
    "object": "create.masked_result",
    "results": [
      {
        "index": 0,
        "file_name": "report1_masked.jpg",
        "status": "SUCCESS",
        "url": "https://oss.easylink-ai.com/************.jpg",
        "masked_fields": ["患者姓名", "患者性别"]
      }
    ]
  }
}

失败响应示例

{
  "success": false,
  "err_code": "MISSING_FILE",
  "err_message": "未上传任何文件"
}

响应字段说明

字段名	类型	说明
`success`	boolean	请求是否成功
`data`	object	任务或结果
`data.task_id`	string	任务 ID
`data.status`	string	PROCESSING / SUCCESS / FAILED
`data.object`	string	create.masked_result
`data.results`	array	结果列表
`data.results[].index`	integer	文件索引
`data.results[].file_name`	string	文件名
`data.results[].status`	string	SUCCESS / FAILED
`data.results[].url`	string	文件访问地址
`data.results[].masked_fields`	array	被脱敏字段

错误码说明

err_code	说明
EMPTY_TASK	非法的任务请求
ILLEGALITY_TASK_TYPE	非法任务类型
API_UNAUTHORIZED	API 未授权
INVALID_PARAMETER	无效参数
INVALID_DOCUMENT	文件不可处理
INSUFFICIENT_BALANCE	余额不足

病历脱敏

On this page