Obtenir un endpoint de webhook
curl --request GET \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
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/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true,
"disabledReason": {},
"failingSince": {},
"previousSecretExpiresAt": {},
"version": 123,
"createdAt": "<string>",
"updatedAt": "<string>"
}Endpoints de webhook
Obtenir un endpoint de webhook
Lisez un endpoint de webhook d’intégration avec ses événements, son filtre de workspaces, son statut, son état d’échec et l’expiration d’un ancien secret.
GET
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
Obtenir un endpoint de webhook
curl --request GET \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
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/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true,
"disabledReason": {},
"failingSince": {},
"previousSecretExpiresAt": {},
"version": 123,
"createdAt": "<string>",
"updatedAt": "<string>"
}Renvoie un endpoint et son
Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans Codes d’erreur. Sur
ETag. Utilisez l’ETag comme If-Match lorsque vous mettez à jour ou supprimez l’endpoint.
Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Consultez Webhooks d’intégration.
Réponse
Renvoie200 avec ETag et l’endpoint.
URL HTTPS publique complète qui reçoit les événements. Chaque clé qui peut lire les webhooks de l’équipe, clés en lecture seule comprises, la reçoit ; un jeton dans l’URL n’est donc pas un secret : vérifiez
X-Qwairy-SignatureTypes d’événements que l’endpoint reçoit
Workspaces auxquels l’endpoint est limité. Un tableau vide signifie tous les workspaces de l’équipe
Date à laquelle l’ancien secret de signature cesse d’être utilisé, après un renouvellement, au format ISO 8601
Requête et réponse synthétiques
curl -i "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
# ETag: "0"
{
"id": "eeeeeeee-0000-4000-8000-000000000000",
"url": "https://hooks.example.com/qwairy",
"description": "Production receiver",
"events": ["run.completed", "run.failed"],
"brandIds": [],
"enabled": true,
"disabledReason": null,
"failingSince": null,
"previousSecretExpiresAt": null,
"version": 0,
"createdAt": "2026-10-12T09:00:00.000Z",
"updatedAt": "2026-10-12T09:00: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 | L’endpoint est absent ou appartient à une autre équipe |
429, respectez Retry-After.
