Aller au contenu principal

Deploy Hook

Open in QuickMonitoring→ Sites → [Votre site] → Paramètres → Deploy Hook

Le Deploy Hook est une URL secrète générée par QuickMonitoring pour chaque site. Collez cette URL dans votre plateforme de déploiement — Railway, Vercel, Netlify ou tout pipeline CI/CD. À chaque déploiement réussi, une requête POST vers cette URL déclenche automatiquement un scan standard sur votre site.

Ce que vous verrez​

Dans Paramètres → Deploy Hook de votre site, vous trouverez :

  • L'URL du Deploy Hook : une URL unique contenant un jeton secret dans le chemin (ex. : https://api.quickmonitoring.com/api/v1/deploy-hook/VOTRE_CLE_SECRETE), accompagnée d'un bouton Copier
  • Les fiches de configuration par plateforme : des instructions contextuelles pour Railway, Vercel et Netlify
  • Le bouton Régénérer : permet de générer une nouvelle URL et d'invalider immédiatement l'ancienne
  • L'historique des déclenchements : les dernières requêtes reçues avec leur date, heure et statut (scan déclenché ou ignoré)

Aucun en-tête d'authentification n'est nécessaire — le secret est intégré dans l'URL elle-même.

Comment le configurer​

Railway​

  1. Copiez l'URL du Deploy Hook depuis Paramètres → Deploy Hook.
  2. Dans Railway, ouvrez votre service et rendez-vous dans Settings → Deploy → Webhooks.
  3. Collez l'URL et sauvegardez.

Railway enverra automatiquement une requête POST vers cette URL à la fin de chaque déploiement réussi.

Vercel​

  1. Copiez l'URL du Deploy Hook depuis Paramètres → Deploy Hook.
  2. Dans Vercel, ouvrez votre projet et rendez-vous dans Settings → Git → Deploy Hooks.
  3. Donnez un nom à votre hook (ex. : QuickMonitoring QA) et collez l'URL.
  4. Sauvegardez — Vercel génère une URL de hook Vercel distincte qui appellera votre Deploy Hook QuickMonitoring à chaque déploiement.

Netlify​

  1. Copiez l'URL du Deploy Hook depuis Paramètres → Deploy Hook.
  2. Dans Netlify, ouvrez votre site et rendez-vous dans Site → Build & deploy → Deploy notifications.
  3. Cliquez sur Add notification → Outgoing webhook.
  4. Sélectionnez l'événement Deploy succeeded et collez l'URL dans le champ URL to notify.
  5. Sauvegardez.

GitHub Actions​

Ajoutez une étape à la fin de votre workflow de déploiement pour appeler le Deploy Hook après une livraison réussie :

- name: Trigger QA scan
  run: curl -X POST https://api.quickmonitoring.com/api/v1/deploy-hook/YOUR_HOOK_KEY

Conservez la clé secrète dans les secrets GitHub (${{ secrets.QM_DEPLOY_HOOK_KEY }}) plutôt qu'en clair dans le fichier de workflow :

- name: Trigger QA scan
  run: curl -X POST https://api.quickmonitoring.com/api/v1/deploy-hook/${{ secrets.QM_DEPLOY_HOOK_KEY }}

Régénération de l'URL​

Cliquez sur Régénérer dans Paramètres → Deploy Hook pour créer une nouvelle URL secrète. L'ancienne URL est immédiatement invalidée — toute requête POST vers l'ancienne URL sera ignorée sans déclencher de scan. Pensez à mettre à jour votre plateforme de déploiement avec la nouvelle URL dès que vous régénérez.

Condition de réussite​

✅ Vous obtenez ce badge lorsqu'au moins un scan a été déclenché avec succès via le Deploy Hook de votre site.

Problèmes fréquents​

  • Le scan ne se déclenche pas après un déploiement — Vérifiez que la requête POST parvient bien à QuickMonitoring en consultant l'historique des déclenchements dans Paramètres → Deploy Hook. Si aucune entrée n'apparaît, la requête n'atteint pas nos serveurs : vérifiez l'URL configurée dans votre plateforme de déploiement et assurez-vous qu'aucun pare-feu ou proxy ne bloque les requêtes sortantes.

  • Le scan est ignoré alors que la requête est reçue — Si un scan est déjà en cours pour ce site au moment où le Deploy Hook est appelé, le déclenchement est ignoré pour éviter les scans simultanés. Attendez la fin du scan en cours — le prochain déploiement déclenchera le scan normalement.

  • L'ancienne URL ne fonctionne plus après régénération — C'est le comportement attendu. Après une régénération, mettez à jour l'URL dans toutes les plateformes de déploiement concernées. Vérifiez également que vous n'avez pas d'autres pipelines ou scripts qui utilisaient l'ancienne URL.

  • Je veux tester le Deploy Hook sans effectuer un déploiement — Exécutez manuellement la commande curl en remplaçant YOUR_HOOK_KEY par votre clé réelle. Vous verrez l'entrée apparaître dans l'historique des déclenchements et le scan démarrera dans les secondes suivantes.