Aller au contenu

Démarrage rapide : analyser un premier fichier

Envoyez un fichier à l'antivirus Wakastart avec cURL, suivez l'analyse et lisez le verdict, en cinq minutes.

Démarrage rapideDéveloppeur
Durée
5 min
Voir en Markdown

Vous allez envoyer un fichier à l'antivirus, suivre son analyse jusqu'au verdict, puis lire le détail du résultat. Tout se fait depuis un terminal, avec cURL.

Ce que vous allez construire

Un aller-retour complet avec l'API publique https://api.wakastart.app/api : un fichier envoyé, un identifiant de scan reçu, un statut qui passe de PENDING à CLEAN.

Avant de commencer

  • Une clé API sk_… rattachée à votre application et à votre client, dont le profil porte les droits Lancer un scan antivirus et Voir le module antivirus. Voir Autoriser votre serveur.
  • Au moins un crédit sur le solde du client. Voir Crédits.
  • cURL et un fichier de moins de 50 Mo, par exemple facture-2026-10.pdf.

Exportez votre clé dans une variable pour ne pas la taper à chaque commande :

Bash
export WAKASTART_API_KEY="sk_test_exemple"

1. Envoyer le fichier

Bash
curl -X POST "https://api.wakastart.app/api/antivirus/scans" \
  -H "x-api-key: $WAKASTART_API_KEY" \
  -F "file=@facture-2026-10.pdf"

Réponse attendue (201 Created) :

JSON
{
  "id": "3f6c1a52-8d4e-4b7a-9c21-5e0f7b2d9a10",
  "customerWid": "EXCLI1",
  "appWid": "EXAPP1",
  "filename": "facture-2026-10.pdf",
  "fileSize": 248913,
  "mimeType": "application/pdf",
  "status": "PENDING",
  "priority": 5,
  "queuedAt": "2026-10-23T09:12:04.512Z",
  "completedAt": null
}

La réponse complète contient d'autres champs, tous décrits dans la référence. Notez la valeur de id : c'est l'identifiant du scan. Un crédit vient d'être débité.

2. Suivre l'analyse

Bash
curl "https://api.wakastart.app/api/antivirus/scans/3f6c1a52-8d4e-4b7a-9c21-5e0f7b2d9a10/status" \
  -H "x-api-key: $WAKASTART_API_KEY"

Réponse attendue une fois l'analyse terminée :

JSON
{
  "id": "3f6c1a52-8d4e-4b7a-9c21-5e0f7b2d9a10",
  "status": "CLEAN",
  "filename": "facture-2026-10.pdf",
  "completedAt": "2026-10-23T09:12:05.931Z"
}

Si status vaut encore PENDING ou SCANNING, relancez la commande deux secondes plus tard.

3. Lire le détail du résultat

Bash
curl "https://api.wakastart.app/api/antivirus/scans/3f6c1a52-8d4e-4b7a-9c21-5e0f7b2d9a10" \
  -H "x-api-key: $WAKASTART_API_KEY"

Le détail ajoute l'empreinte SHA-256 du fichier (fileHash), la version du moteur (scanEngine), la version de la base de signatures (signatureVersion) et la durée d'analyse (scanDurationMs). Pour un fichier infecté, threatName donne le nom de la menace.

4. Vérifier que ça marche

Testez la détection avec le fichier de test EICAR, reconnu par tous les antivirus et sans danger :

Bash
printf '%s' 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > eicar.txt
curl -X POST "https://api.wakastart.app/api/antivirus/scans" \
  -H "x-api-key: $WAKASTART_API_KEY" \
  -F "file=@eicar.txt"

Suivez ce second scan comme à l'étape 2 : son statut final est INFECTED, et son détail indique "threatName": "Win.Test.EICAR_HDB-1".

Étapes suivantes