Envoyer un événement de test
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/test \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/test"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"eventId": "<string>",
"event": "<string>",
"status": "<string>",
"attempts": 123,
"nextAttemptAt": {},
"lastAttemptAt": {},
"lastStatusCode": {},
"lastError": {},
"deliveredAt": {},
"createdAt": "<string>"
}Endpoints de webhook
Envoyer un événement de test
Mettez en file un événement webhook.test pour un endpoint de webhook d’intégration, même désactivé, afin de vérifier votre récepteur et la signature.
POST
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
/
test
Envoyer un événement de test
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/test \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/test"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"eventId": "<string>",
"event": "<string>",
"status": "<string>",
"attempts": 123,
"nextAttemptAt": {},
"lastAttemptAt": {},
"lastStatusCode": {},
"lastError": {},
"deliveredAt": {},
"createdAt": "<string>"
}Met en file un événement
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie
webhook.test pour cet endpoint uniquement, même s’il est désactivé. Utilisez-le pour vérifier que votre récepteur est joignable et que votre vérification de signature réussit. Lisez le résultat avec Lister les envois.
Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Modifier un endpoint exige aussi un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Webhooks d’intégration et Écrire des données.
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
Réponse
Renvoie202 avec l’envoi mis en file.
Identifiant de l’envoi, stable entre les tentatives. Il est aussi envoyé dans l’en-tête
X-Qwairy-DeliveryRequête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID/test" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: webhook-test-001"
{
"id": "ffffffff-0000-4000-8000-000000000000",
"eventId": "evt_3f2a9c1e-5b7d-4e08-8a41-0c9d6e2b7f10",
"event": "webhook.test",
"status": "PENDING",
"attempts": 0,
"nextAttemptAt": "2026-10-12T09:00:00.000Z",
"lastAttemptAt": null,
"lastStatusCode": null,
"lastError": null,
"deliveredAt": null,
"createdAt": "2026-10-12T09:00:00.000Z"
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
404 | RESOURCE_NOT_FOUND | L’endpoint est absent ou appartient à une autre équipe |
409 | IDEMPOTENCY_CONFLICT | La clé a été réutilisée avec une requête différente |
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.
