Passer au contenu principal
POST
Renouveler le secret de signature
Renvoie un nouveau secret de signature, une seule fois. Pendant 24 heures après le renouvellement, chaque envoi porte deux signatures séparées par une virgule dans X-Qwairy-Signature : la nouvelle d’abord, puis l’ancienne. Les récepteurs peuvent déployer le nouveau secret sans perdre d’événements. Consultez Vérifier les signatures. 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.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant de l’endpoint.

Réponse

Renvoie 200, le nouvel ETag et l’endpoint avec son nouveau secret. previousSecretExpiresAt indique l’heure à laquelle l’ancien secret cesse d’être utilisé. Les autres champs sont décrits dans Lister les endpoints de webhook.

Requête et réponse synthétiques

Erreurs

Consultez Codes d’erreur 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.