Démarrage rapide

Trois appels pour vérifier votre accès et obtenir un premier devis dans la sandbox. Comptez 10 minutes.

1. Préparez vos accès

COVERAF vous a transmis deux valeurs, affichées une seule fois :

une clé API de test, qui commence par cvr_test_ ;
un secret de signature, qui commence par cvr_sig_.

Rangez-les dans les variables d'environnement de votre serveur, jamais dans votre code source ni dans une application mobile :

Terminal

export COVERAF_CLE_API="cvr_test_..."
export COVERAF_SECRET="cvr_sig_..."

2. Vérifiez votre clé

GET /v1/ping répond si votre clé est valide et indique l'environnement :

curl

curl https://api.coveraf.com/v1/ping \
  -H "Authorization: Bearer $COVERAF_CLE_API"

Réponse 200

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

3. Demandez un devis

Toute demande qui écrit (devis, souscription, paiement) est signée avec votre secret. Le plus simple est de partir de notre petit client prêt à l'emploi, dans votre langage : Node.js, Python, PHP ou bash (curl).

import { appelCoveraf } from './coveraf.js'

const devis = await appelCoveraf('POST', '/v1/devis', {
  "offre": "securvie_500k",
  "donnees": {
    "assure": {
      "date_naissance": "1985-06-15"
    }
  },
  "reference_partenaire": "CMD-2026-0042"
})
console.log(devis.id, devis.prime.totale)

Réponse 201

{
  "id": "dev_68e56446d4b5c6875911f178",
  "objet": "devis",
  "environnement": "test",
  "offre": "securvie_500k",
  "produit": "vie",
  "prime": {
    "nette": 11000,
    "accessoires": 0,
    "taxes": 1980,
    "totale": 12980,
    "devise": "XOF"
  },
  "duree_mois": 12,
  "detail": null,
  "donnees": {
    "assure": {
      "date_naissance": "1985-06-15"
    }
  },
  "reference_partenaire": "CMD-2026-0042",
  "expire_le": "2026-11-19T17:35:33.439+00:00",
  "expire": false,
  "cree_le": "2026-11-04T17:35:33.447204+00:00"
}

Le prix (prime.totale, en FCFA) est calculé par COVERAF et garanti jusqu'à expire_le.

Et ensuite ?

Le devis se transforme en contrat en deux étapes, souscription puis paiement : voir Parcours de souscription. La liste des offres et de leurs champs est dans Produits.

Une erreur ?

Chaque erreur renvoie un code stable, un message en français et un requete_id. Signature refusée : vérifiez que vous signez exactement le corps envoyé et le chemin appelé (voir Authentification et signature).