Vérifier sa signature

Vérifie en plus votre signature. Renvoie le corps reçu (signature_verifiee: true). Ne crée rien.

POSThttps://api.coveraf.com/v1/ping

SignéRéponse JSON 200Sandbox et production

Mettre au point la signature

Tant que cet appel ne renvoie pas signature_verifiee: true, inutile d'essayer les devis : corrigez d'abord la chaîne signée (voir Authentification et signature).

En-têtes

En-tête	Obligatoire	Valeur
`Authorization`	oui	Bearer suivi de votre clé API (`cvr_test_...` ou `cvr_live_...`).
`Content-Type`	oui	`application/json`
`X-Coveraf-Timestamp`	oui	Heure actuelle, horodatage Unix en secondes.
`X-Coveraf-Signature`	oui	`v1=` suivi du HMAC-SHA256 de la requête. Comment signer

Corps de la requête

N'importe quel objet JSON, y compris {}. Il est signé comme toute écriture.

Exemple de requête

./coveraf.sh POST /v1/ping '{"test":"signature"}'

Les fonctions appelCoveraf, appel_coveraf et le script coveraf.sh signent la requête pour vous : téléchargez-les.

Réponse

Succès (200)

{
  "ok": true,
  "environnement": "test",
  "partenaire": "Votre société",
  "signature_verifiee": true,
  "date_serveur": "2026-11-04T17:35:32.433Z",
  "recu": {
    "test": "signature"
  }
}

Erreurs possibles

Code	HTTP	Signification
`signature_manquante`	401	Requête d'écriture non signée. Envoyez X-Coveraf-Timestamp et X-Coveraf-Signature.
`signature_invalide`	401	Signature invalide. Vérifiez votre secret de signature et la chaîne signée.
`signature_expiree`	401	Horodatage trop ancien ou dans le futur (plus de 5 minutes). Vérifiez l'horloge de votre serveur.
`json_invalide`	400	Le corps de la requête n'est pas du JSON valide.

S'y ajoutent les erreurs communes à tous les appels (clé, signature, limite de débit, service) : voir Codes d'erreur.