Esta API es fácil de usar. Solo tienes que seguir estos pasos

• Crear una cuenta gratis
• Haz clic en el enlace que recibas por correo para confirmar tu dirección.
• Generar un token con credenciales

Puedes usar cualquier lenguaje para realizar esta llamada CURL. (Python, PHP, Java, JavaScript...) ¿Necesitas ayuda?

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

Si tus credenciales son correctas, nuestro servidor te proporcionará un token como respuesta: {"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}
YOUR_TOKEN es válido durante una hora; su duración puede ampliarse usando YOUR_REFRESH_TOKEN.


• Usa el token para iniciar el proceso de forma asíncrona
Descargando resultados: Cuando está presente en una respuesta de la API, actionResultsDownloadURLs contiene las URL autenticadas para descargar cada archivo de resultado generado.



API asíncrona: inspección universal de archivos

Envía un archivo no vacío de hasta 50 MiB. El original se lee, pero nunca se mueve, modifica ni elimina. El informe es diagnóstico: el resultado del antivirus es una señal preliminar de triaje y el conjunto de reglas incluido solo es un punto de partida mínimo.

Punto de acceso: POST https://mxprocess.com/api/files/start-process
Autenticación: Bearer JWT
Coste: 12 tokens, cobrados después del éxito.

Iniciar una inspección

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'

Guarda el id y consulta /api/actions/get-action-infos/{id} con el mismo JWT. Cuando termine, actionResults contiene un archivo autenticado descargable *.inspection.json .

Respuesta inicial

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

Ejemplo de respuesta correcta

{ "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" }

Si una herramienta local opcional no está disponible, su sección se devuelve como not_run o null. Una cardinalidad no válida, un archivo inaccesible o un archivo de más de 50 MiB se rechaza antes del análisis.

Contáctenos


La API envía una respuesta JSON para confirmar que el proceso ha comenzado. Anota el campo « trackingUrl », que permite seguir el proceso iniciado. La respuesta también contiene su ID; en este ejemplo es 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" }


• Para seguir el progreso, realiza una solicitud GET sencilla (puedes hacer esta llamada HTTP cada 10 segundos):
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

Si el proceso aún no ha terminado, recibirás este tipo de respuesta con "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": "" }

Si el proceso ha terminado, recibirás este tipo de respuesta con "accomplished": true. El campo actionResultsDownloadURLs contiene las URL autenticadas para descargar los resultados generados: { "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": "" }

Usa directamente cada URL proporcionada en actionResultsDownloadURLs para descargar el resultado correspondiente.

¿La documentación no es clara? (Python, PHP, Java, JavaScript...) ¿Necesitas ayuda?

Contáctenos Esta API también está disponible en modo síncrono: API para desarrolladores : FileInspection