Tester les notifications

Envoie tout de suite un événement test.ping à votre adresse de notification et indique ce qu'elle a répondu (recu, statut_http, erreur).

POSThttps://api.coveraf.com/v1/webhooks/test

SignéRéponse JSON 200Sandbox et production

Configuration préalable

Votre adresse de notification doit avoir été communiquée à COVERAF. Voir Notifications.

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/webhooks/test '{}'

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)

{
  "evenement_id": "evt_5f1c2a9be04d77a3c1d2e8f0",
  "adresse": "https://app.votre-societe.ci/webhooks/coveraf",
  "recu": true,
  "statut_http": 200,
  "erreur": null
}

Erreurs possibles

Code	HTTP	Signification
`webhook_non_configure`	409	Aucune adresse de notification n'est configurée pour cet environnement. Demandez-la à COVERAF.

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