> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lancer un audit de pages

> Auditez jusqu’à 50 pages suivies, ou toutes, pour 5 crédits par page. Prévisualisez le coût avec dryRun, puis interrogez l’audit ou attendez le webhook.

Audite jusqu’à 50 pages suivies, ou toutes les pages suivies avec `all` défini sur `true`. La requête renvoie `202` avec l’audit et un en-tête `Location`. Interrogez [Obtenir un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/get-audit.md), ou abonnez un [webhook d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md) à [`site_audit.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#site_audit-completed). Les pages déjà en cours d’audit sont signalées comme `SKIPPED` dans l’audit.

Chaque page auditée consomme **5 crédits**, comme dans le tableau de bord. Le solde est vérifié avant l’acceptation ; chaque page réserve ses crédits au démarrage de son traitement et les consomme à l’enregistrement de ses résultats. `creditsReserved` est le budget de l’audit, pas une réservation immédiate ni une facture. Envoyez `dryRun: true` pour le prévisualiser sans rien lancer.

Un `202` signifie que la demande est enregistrée durablement, pas que toutes les pages ont démarré. La requête met elle-même en file un audit de 100 pages à auditer ou moins. Un audit plus grand est renvoyé sans attendre : ses pages sont `QUEUED`, et une tâche d’arrière-plan qui s’exécute toutes les cinq minutes les met en file, parfois avant l’arrivée de la réponse. La mise en file est relancée dans les 24 heures qui suivent l’acceptation, avec 12 tentatives au plus, la première comprise ; une tentative interrompue avant d’enregistrer son issue peut s’exécuter de nouveau dans cette fenêtre. Les pages que la file n’a pas prises à ce terme sont `FAILED`. Chaque tentative réutilise les mêmes clés, si bien qu’une page n’est jamais mise en file ni débitée deux fois. Consultez le même audit plutôt que d’en créer un nouveau.

Si le solde est déjà insuffisant, la requête renvoie `409` `INSUFFICIENT_CREDITS` et ne lance rien. Si le solde est épuisé après l’acceptation, la réponse dépend de l’avancement de l’audit. Lorsqu’aucune page n’a démarré et que la requête a mis elle-même l’audit en file (100 pages à auditer ou moins), le même `409` contient `details.auditId` : l’audit est conservé avec ses pages `FAILED` et reste consultable. Dans tous les autres cas, y compris un audit mis en file par la tâche d’arrière-plan, la réponse reste `202` : les pages qui n’ont pas pu démarrer sont `FAILED`, les pages déjà démarrées continuent, et l’audit indique l’issue de chaque page.

Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**pageIds** `string[]`

Entre 1 et 50 identifiants de pages suivies. Ne peut pas être combiné avec `all`.

**all** `boolean`

Audite toutes les pages suivies, dans la limite de 10 000. Au-delà, utilisez plusieurs requêtes avec `pageIds`. Ne peut pas être combiné avec `pageIds`.

Envoyez soit `pageIds`, soit `all`.

**dryRun** `boolean` (default: false)

Renvoie les pages et `creditsReserved` sans lancer l’audit ni réserver de crédits. La réponse est `200` avec `status: "PREVIEW"` et `id: null`.

## Réponse

Renvoie `202` avec un objet d’audit, ou `200` avec un audit `PREVIEW` lorsque `dryRun` vaut `true`. `creditsReserved` vaut 5 crédits par page à auditer et peut diminuer si des pages sont refusées à l’envoi. Pour un dry run, il s’agit du budget estimé. Consultez [Obtenir un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/get-audit.md) pour les champs.

## Requête et réponse synthétiques

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/site-diagnostics/audits" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: audit-pricing-001" \
  -H "Content-Type: application/json" \
  -d '{"pageIds":["99999999-0000-4000-8000-000000000000"]}'
```

```json theme={null}
{
  "id": "aaaaaaaa-0000-4000-8000-000000000000",
  "status": "RUNNING",
  "counts": { "total": 1, "succeeded": 0, "failed": 0, "skipped": 0, "running": 1 },
  "creditsReserved": 5,
  "pages": [
    {
      "pageId": "99999999-0000-4000-8000-000000000000",
      "status": "QUEUED",
      "completedAt": null
    }
  ],
  "createdAt": "2026-10-12T09:00:00.000Z",
  "completedAt": null
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | `pageIds` et `all` sont combinés, les deux sont absents, ou une valeur est invalide |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace est absent ou inaccessible |
| `409` | `INSUFFICIENT_CREDITS` | Le solde de l’équipe ne couvre pas 5 crédits par page |
| `409` | `CONFLICT` | La requête entre en conflit avec l’état actuel |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie `403 API_KEY_READ_ONLY`. Sur `429`, respectez `Retry-After`. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie `503 SERVICE_UNAVAILABLE` et rien ne change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.