Obtenir un audit de pages
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": {},
"status": "<string>",
"creditsReserved": 123,
"counts": {},
"pages": [
{}
],
"createdAt": "<string>",
"completedAt": {}
}Diagnostic du site
Obtenir un audit de pages
Lisez le statut d’un audit de pages et l’avancement de chaque page auditée. Interrogez-le après une réponse 202, ou attendez le webhook site_audit.completed.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
site-diagnostics
/
audits
/
{siteAuditId}
Obtenir un audit de pages
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/site-diagnostics/audits/{siteAuditId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": {},
"status": "<string>",
"creditsReserved": 123,
"counts": {},
"pages": [
{}
],
"createdAt": "<string>",
"completedAt": {}
}Renvoie le statut d’un audit de pages et le statut de chaque page auditée. C’est la ressource identifiée par l’en-tête
Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans Codes d’erreur. Sur
Location de Lancer un audit de pages.
Le résultat final de chaque page appartient à cet audit et ne change pas lorsqu’un nouvel audit est lancé. COMPLETED signifie que toutes les pages ont atteint un état final, pas qu’elles ont toutes réussi : consultez counts.failed et counts.skipped. Un traitement interrompu peut rester QUEUED ou AUDITING pendant la récupération de son résultat exact. Une page dont le traitement ne peut plus exister est FAILED : la mise en file est relancée dans les 24 heures qui suivent l’acceptation, 12 fois au plus, et les traitements en file expirent après 7 jours. Un traitement encore actif dans la file est attendu. Obtenir une page suivie renvoie les scores les plus récents de cette page, qui peuvent provenir d’un audit ultérieur.
Disponible avec les offres Growth, Agency Growth, Business, Agency Business et Enterprise. Consultez Authentification.
Réponse
Identifiant de l’audit.
null uniquement pour un dry run, que cet endpoint ne renvoie jamaisBudget de l’audit : 5 crédits par page à auditer, ajusté si des pages sont refusées à l’envoi. Ni une réservation immédiate ni le montant final consommé
Une entrée par page avec
pageId, status (QUEUED, AUDITING, COMPLETED, FAILED ou SKIPPED) et completedAt (nullable).Date de fin de l’audit au format ISO 8601, ou
null pendant son exécution. Dès que l’événement site_audit.completed existe, c’est le completedAt de cet événement. Elle peut être postérieure à la date de la dernière page lorsque les dernières pages ont été ignorées ou que la mise en file s’est close plus tardRequête et réponse synthétiques
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/site-diagnostics/audits/$SITE_AUDIT_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"id": "aaaaaaaa-0000-4000-8000-000000000000",
"status": "COMPLETED",
"counts": { "total": 1, "succeeded": 1, "failed": 0, "skipped": 0, "running": 0 },
"creditsReserved": 5,
"pages": [
{
"pageId": "99999999-0000-4000-8000-000000000000",
"status": "COMPLETED",
"completedAt": "2026-10-12T09:03:00.000Z"
}
],
"createdAt": "2026-10-12T09:00:00.000Z",
"completedAt": "2026-10-12T09:03:00.000Z"
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
401 | Corps plat | Jeton absent ou invalide |
403 | INSUFFICIENT_PLAN | Refus d’offre générique : "This endpoint is not included in the team's plan." |
404 | RESOURCE_NOT_FOUND | Le workspace ou l’audit est absent ou inaccessible |
429, respectez Retry-After.
