# 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.

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](/v1.0/glossaire#clé-api) `sk_…` rattachée à votre application et à votre [client](/v1.0/glossaire#client), dont le profil porte les droits **Lancer un scan antivirus** et **Voir le module antivirus**. Voir [Autoriser votre serveur](/v1.0/antivirus/autoriser-votre-serveur).
- [ ] Au moins un crédit sur le solde du client. Voir [Crédits](/v1.0/credits).
- [ ] 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](/v1.0/antivirus/reference#objet-scan). 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

::::cards{cols=3}
:::card{title="Cycle de vie d'une analyse" href="/v1.0/antivirus/cycle-de-vie-d-une-analyse" icon="Timer"}
Comprendre chaque statut et les nouvelles tentatives.
:::
:::card{title="Recevoir le résultat par webhook" href="/v1.0/antivirus/recevoir-le-resultat-par-webhook" icon="Webhook"}
Ne plus interroger l'API et vérifier la signature.
:::
:::card{title="Liste de contrôle" href="/v1.0/antivirus/liste-de-controle" icon="ListChecks"}
Tout vérifier avant d'ouvrir le téléversement en production.
:::
::::
