Fonctionnement de la signature
L’en-têteX-Qwairy-Signature est sha256= suivi du HMAC-SHA256 hexadécimal, calculé avec votre secret de signature, de cette chaîne :
- Utilisez les octets bruts du corps, avant tout parsing JSON. Un corps parsé puis resérialisé produit une signature différente.
X-Qwairy-Timestampest l’heure Unix en secondes à laquelle cette tentative a été signée. Chaque nouvelle tentative est signée à nouveau avec un nouvel horodatage.- Comparez en temps constant.
- Rejetez les requêtes dont l’horodatage s’écarte de plus de 5 minutes de votre horloge. Cela limite le rejeu d’une requête interceptée.
Vérifier votre code avec un vecteur de test
Cet exemple synthétique vous permet de valider votre implémentation. Il utilise le secretsynthetic-signing-secret et l’horodatage 1793610000.
Node.js
Python
Renouveler le secret
Après Renouveler le secret de signature, l’en-têteX-Qwairy-Signature porte deux valeurs séparées par une virgule pendant 24 heures. La première est signée avec le nouveau secret et la seconde avec l’ancien :
- Renouvelez le secret et conservez la nouvelle valeur.
- Déployez le nouveau secret sur votre récepteur. Les requêtes continuent de passer pendant la période de chevauchement, quel que soit le secret que vous détenez.
- Après 24 heures, les requêtes portent de nouveau une seule signature.
previousSecretExpiresAt dans l’endpoint indique la fin du chevauchement.
Dépannage
- Toutes les requêtes échouent. Vérifiez que vous signez le corps brut et non un corps resérialisé, et qu’aucun middleware ne le modifie avant votre gestionnaire.
- Seules certaines requêtes échouent. Vérifiez l’horloge de votre serveur par rapport à la tolérance de 5 minutes.
- Une requête échoue après un renouvellement. Vérifiez que vous utilisez le nouveau secret et que vous comparez chaque valeur de l’en-tête.

