文件校验

POST

/openapi/file/validate

文档做预检与「可打开」类校验，用于在正式提交任务前判断文件是否可用。

file 与 fileUrl 二选一，禁止同时传

data.valid === true | false

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app-test.fagougou.com/openapi/file/validate' \
--header 'access-token: 49ddcd0a2a91467bba7fa6d55a0f2c3b' \
--form 'file=@""' \
--form 'fileUrl="https://example.com/files/sample.docx"' \
--form 'filename="sample.docx"'

返回响应

🟢200

application/json

请求处理完成（含业务上校验未通过的情况）。是否通过校验以 data.valid 为准。

Bodyapplication/json

示例

校验通过校验未通过（Office 引擎无法打开）不支持的格式

{
    "code": 200,
    "message": "校验通过",
    "data": {
        "valid": true,
        "lane": "office_word",
        "guarantee_level": "open_and_probe",
        "error": null
    }
}

🟠400

🟠404

🟠413

🔴500

修改于 2026-04-17 01:27:09

文件上传

OFD转图片（返回图片集合的压缩包）