文件校验

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 --request POST 'https://app-test.fagougou.com/openapi/file/validate' \
--header 'timestamp: {{$date.timestamp}}' \
--header 'nonce: AcGIU5JK9KjKk7vq' \
--form 'file=@""' \
--form 'fileUrl="https://example.com/files/sample.docx"' \
--form 'filename="sample.docx"'

返回响应

🟢200

application/json

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

Body

示例

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

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

🟠400

🟠404

🟠413

🔴500

修改于 2026-04-16 16:27:41

文件上传

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