Documentation API, Inspecter tout fichier avec son hash, son MIME réel, un signal antivirus préliminaire, ses métadonnées, ses informations média, des règles de détection et un aperçu OCR.

Accueil Tarifs Paramètres Nous contacter

API : Inspecter tout fichier avec son hash, son MIME réel, un signal antivirus préliminaire, ses métadonnées, ses informations média, des règles de détection et un aperçu OCR.

Cette API est simple à utiliser. Il vous suffit de suivre ces étapes

Créer un compte gratuitement
Cliquez sur le lien reçu par e-mail pour confirmer votre adresse.
Générer un jeton avec vos identifiants

Vous pouvez utiliser n’importe quel langage pour effectuer cet appel CURL. (Python, PHP, Java, JavaScript...) Besoin d’aide ?

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

Si vos identifiants sont corrects, notre serveur vous fournira un jeton en réponse :

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

YOUR_TOKEN est valide pendant une heure ; sa durée peut être prolongée avec YOUR_REFRESH_TOKEN.

Utilisez le jeton pour démarrer le traitement

Documentation API, FileInspection

Téléchargement des résultats : Lorsqu’il est présent dans une réponse API, actionResultsDownloadURLs contient les URL authentifiées permettant de télécharger chaque fichier de résultat généré.

API asynchrone : inspection universelle de fichier

Envoyez un fichier non vide de 50 MiB maximum. L’original est lu mais jamais déplacé, modifié ou supprimé. Le rapport est diagnostique : le résultat de l’antivirus est un signal de triage préliminaire et l’ensemble de règles inclus ne constitue qu’un point de départ minimal.

Point d’accès: POST https://mxprocess.com/api/files/start-process
Authentification: JWT Bearer
Coût: 12 jetons, facturés après réussite.

Démarrez une inspection

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'

Enregistrez le id et interrogez /api/actions/get-action-infos/{id} avec le même JWT. Une fois terminé, actionResults contient un fichier authentifié téléchargeable *.inspection.json .

Réponse initiale

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

Exemple de réponse réussie

{
  "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 un outil local facultatif est indisponible, sa section est renvoyée comme not_run ou null. Une cardinalité invalide, un fichier inaccessible ou un fichier de plus de 50 MiB est rejeté avant l’analyse.

Nous contacter

L’API renvoie une réponse JSON confirmant la fin du traitement. Téléchargez les fichiers générés avec les URL authentifiées de 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": ""
}

Cette documentation n’est pas claire ? (Python, PHP, Java, JavaScript...) Besoin d’aide ?

Nous contacter Cette API est également disponible en mode asynchrone : API développeur : FileInspection