Aller au contenu
Support

Consulter une offre

Une offre, avec un exemple de demande de devis prêt à l'emploi (exemple_devis).

GEThttps://api.coveraf.com/v1/produits/{code}
Réponse JSON 200Sandbox et production

En-têtes

En-têteObligatoireValeur
AuthorizationouiBearer suivi de votre clé API (cvr_test_... ou cvr_live_...).

Paramètres de chemin

ChampTypeObligatoireDescription
codetexteouiCode de l'offre, ex. securvie_500k (voir GET /v1/produits).

Exemple de requête

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

Réponse

Succès (200), réponse réelle de la sandbox
{
  "code": "securvie_500k",
  "produit": "vie",
  "libelle": "SecurVie 500 000 FCFA",
  "description": "Assurance temporaire décès : capital versé aux bénéficiaires en cas de décès de l'assuré.",
  "duree": "12 mois",
  "documents": [
    "conditions_generales",
    "conditions_particulieres"
  ],
  "disponible": true,
  "garanties": {
    "capital_deces": 500000,
    "age_max": 65
  },
  "exemple_devis": {
    "offre": "securvie_500k",
    "donnees": {
      "assure": {
        "date_naissance": "1985-06-15"
      }
    }
  }
}

Description de chaque champ : modèle Offre.

Erreurs possibles

CodeHTTPSignification
offre_inconnue404Cette offre n'existe pas. Liste des offres : GET /v1/produits.
offre_non_autorisee403Cette offre n'est pas ouverte à votre compte.

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