API 文档, 检查任意文件的哈希值、真实 MIME、初步防病毒信号、元数据、媒体信息、检测规则结果和 OCR 预览。

API : 检查任意文件的哈希值、真实 MIME、初步防病毒信号、元数据、媒体信息、检测规则结果和 OCR 预览。

此 API 易于使用。只需按照以下步骤操作

免费创建账户
点击通过电子邮件收到的链接以确认您的地址。
使用凭据生成令牌

您可以使用任何语言进行此 CURL 调用。 (Python, PHP, Java, JavaScript...) 需要帮助？

curl --location --request POST 'https://mxprocess.com/api/login_check' \
                                        --header 'Content-Type: application/json' \
                                        --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

如果凭据正确，我们的服务器会在响应中提供令牌：

{"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}

YOUR_TOKEN 的有效期为一小时；可以使用 YOUR_REFRESH_TOKEN 延长有效期。

使用令牌启动流程

API 文档, FileInspection

正在下载结果： 当 API 响应中包含 actionResultsDownloadURLs 时，其中包含用于下载每个生成结果文件的已认证 URL。

异步 API：通用文件检查

提交一个不为空且不超过 50 MiB 的文件。原文件只会被读取，不会被移动、修改或删除。报告用于诊断：防病毒引擎结果只是初步分诊信号，随附的检测规则集也只是最小起始集合。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT
费用: 12 令牌，在成功后收费。

开始检查

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'actionName=FileInspection' \
--form 'file=@/path/to/file.bin' \
--form 'parameters=[]' \
--form 'async=true'

保存返回的 id 并轮询 /api/actions/get-action-infos/{id} 使用相同的 JWT。完成后， actionResults 包含一个经过身份验证、可下载的 *.inspection.json 文件。

初始响应

{"id":123,"action":{"actionName":"FileInspection","slug":"inspect-file-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

成功响应示例

{
  "fileName": "photo.jpg",
  "sizeBytes": 24576,
  "sha256": "...",
  "mimeDetected": "image/jpeg",
  "mimeDeclared": null,
  "antivirusSignal": {"status": "clean", "detail": "preliminary triage signal"},
  "exif": {"ImageWidth": 800, "ImageHeight": 600},
  "mediaProbe": null,
  "detectionRules": {"status": "clean", "matches": [], "ruleset": "minimal detection rule set"},
  "ocrText": "Complete text detected in the image...",
  "generatedAt": "2026-09-12T12:00:00+00:00"
}

如果可选的本地工具不可用，其部分结果会返回为 not_run 或 null。如果数量无效、文件无法访问或文件超过 50 MiB，将在分析前拒绝。

联系我们

API 会发送 JSON 响应确认流程已完成。使用以下经过身份验证的 URL 下载生成的文件： actionResultsDownloadURLs.


{
    "actionResultsDownloadURLs": [
        "https://mxprocess.com/api/actions/download-result/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3/YOUR_TOKEN"
    ],
    "id": 1016,
    "actionParameters": [],
    "dateOfDemand": "2024-02-07T20:51:42+00:00",
    "startTime": "2024-02-07T20:51:46+01:00",
    "endTime": "2024-02-07T20:51:46+01:00",
    "hostedFileIds": [
        {
            "fileId": 1025,
            "parameters": ""
        }
    ],
    "action": {
        "actionName": "FileInspection",
        "slug": "inspect-file-online",
        "jsonRequestSample": null,
        "jsonResponseSample": null,
        "specificDeveloperRequestDocumentation": null,
        "specificDeveloperResponseDocumentation": null,
        "longDescription": null
    },
    "user": [],
    "accomplished": true,
    "userIsNotifiedByEmail": "off",
    "userIsNotifiedByPostQuery": "off",
    "actionResults": [
        [
            "a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3",
            "https://mxprocessfiles.s3.eu-west-1.amazonaws.com/AudioToGPT/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3"
        ]
    ],
    "priceInTokensAtTimeOfUse": 15,
    "retryCount": 0,
    "executionPlannedAt": null,
    "trackingUrl": ""
}

这份文档是否不清晰？ (Python, PHP, Java, JavaScript...) 需要帮助？

联系我们此 API 也提供异步模式：开发者 API : FileInspection