此 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 响应中包含 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 响应确认流程已启动。请记下“trackingUrl”字段，以便跟踪已启动的流程。响应中还包含流程 ID；本例中的 ID 为 643： { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "FileInspection", "slug": "inspect-file-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/643" }


• 要跟踪进度，请执行简单的 GET 请求（可以每 10 秒调用一次）：
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

如果流程尚未完成，您将收到带有以下内容的响应 "accomplished": false { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": null, "endTime": null, "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "FileInspection", "slug": "inspect-file-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

如果流程已完成，您将收到带有以下内容的响应 "accomplished": true. actionResultsDownloadURLs 字段包含用于下载生成结果的经过身份验证的 URL： { "actionResultsDownloadURLs": [ "https://mxprocess.com/api/actions/download-result/643/35084b44a841ec597be3048df44145e8.txt.log/YOUR_TOKEN" ], "id": 643, "actionParameters": { "commandParameters": "" }, "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": "2024-01-28T11:24:49+01:00", "endTime": "2024-01-28T11:25:09+01:00", "hostedFileIds": [ { "fileId": 608, "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": [ [ "35084b44a841ec597be3048df44145e8.txt.log" ] ], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

直接使用 actionResultsDownloadURLs 中提供的每个 URL 下载对应结果。

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

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