API & intégrations
Intégrez l'assurance d'œuvres d'art à votre plateforme
Assurance embarquée pour les galeries, maisons de ventes, places de marché et transporteurs : affichez une estimation d'assurance instantanée sur chaque œuvre ou lot — à la manière d'un « estimer la livraison » — puis laissez un courtier Cimaise finaliser le devis. Le tout via une simple API.
Estimation instantanée
Ce que voient vos clients
Le widget renvoie une fourchette de prime en temps réel à partir de la valeur de l'œuvre. Essayez — c'est le rendu exact que votre plateforme peut embarquer.
Estimer l'assurance · démo en direct
€
Couverture annuelle
200 € – 300 €/ an
0.8–1.2 % / an
Transport clou à clou (ponctuel)
40 € – 50 €
Estimation indicative, non contractuelle. La prime réelle est établie sur mesure, en valeur agréée, après étude du risque par un courtier Cimaise.
Pour qui
Galeries & places de marché
Proposez une couverture au moment de la vente ou de l'expédition, sans quitter votre tunnel.
Plateformes de fret d'art
Déclenchez un devis clou à clou pour chaque transport ou prêt planifié.
Logiciels de gestion de collection
Offrez à vos utilisateurs une estimation d'assurance à partir de leur inventaire.
Comment ça marche
01
Obtenez une clé API
Nous vous remettons une clé dédiée à votre plateforme.
02
Appelez /v1/quotes
Envoyez les informations du prospect et de l'œuvre en JSON.
03
Un courtier reprend la main
La demande arrive chez nous ; un courtier étudie et recontacte sous 48 h.
Documentation
1. Estimation instantanée
Renvoie une fourchette de prime pour une valeur donnée. Appelable depuis votre frontend (CORS ouvert) ou en serveur-à-serveur.
POST/api/v1/estimate
curl -X POST https://cimaise-assurance.com/api/v1/estimate \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{ "value": 25000, "category": "Peinture" }'{
"ok": true,
"estimate": {
"currency": "EUR",
"value": 25000,
"annual": { "min": 200, "max": 300, "rate": "0.8–1.2 % / an" },
"transport": { "min": 40, "max": 50, "rate": "0,08–0,20 % de la valeur" },
"disclaimer": "Estimation indicative, non contractuelle…"
},
"quoteUrl": "https://cimaise-assurance.com/devis"
}2. Créer une demande de devis
Un seul endpoint pour commencer. Authentification par clé API, corps en JSON, réponse en JSON.
POST/api/v1/quotes
Authentification
Passez votre clé dans l'en-tête Authorization (ou X-API-Key).
Authorization: Bearer VOTRE_CLE_APIParamètres du corps
Champ
Type
Description
nom
string
requis
Nom complet du contact
email
string
requis
Email valide
telephone
string
requis
Numéro de rappel
profil
string
optionnel
Collectionneur, Galerie / marchand, Artiste, Institution / musée, Maison de ventes
valeur
string
optionnel
Fourchette de valeur à assurer
natures
string[]
optionnel
Peinture, Sculpture, Photographie…
besoins
string[]
optionnel
Transport à venir, Prêt / exposition…
codePostal
string
optionnel
Lieu principal de conservation
description
string
optionnel
Contexte libre
partner
string
optionnel
Votre identifiant de plateforme (repris dans la notification)
reference
string
optionnel
Votre référence interne (renvoyée dans la réponse)
Exemple
curl -X POST https://cimaise-assurance.com/api/v1/quotes \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"partner": "ma-galerie",
"reference": "CMD-1042",
"profil": "Collectionneur",
"valeur": "100 — 500 k€",
"natures": ["Peinture"],
"besoins": ["Transport à venir"],
"nom": "Camille Durand",
"email": "camille@exemple.fr",
"telephone": "06 12 34 56 78"
}'Réponse — 201 Created
{
"ok": true,
"id": "q_ab12cd34ef",
"status": "received",
"reference": "CMD-1042"
}Codes d'erreur
401 — clé API manquante ou invalide
422 — champs requis manquants (le détail est renvoyé dans
fields)503 — API non encore activée
Questions fréquentes
Qui peut obtenir un accès API ?
Les galeries, places de marché, transporteurs d'art et éditeurs de logiciels souhaitant proposer l'assurance d'œuvres d'art à leurs clients. L'accès se fait sur demande, avec une clé dédiée.
L'API renvoie-t-elle un tarif instantané ?
La version 1 enregistre la demande de devis et la transmet à un courtier, qui étudie le risque et recontacte. Un tarif se construit sur mesure, en valeur agréée — pas d'algorithme opaque.
Comment sont protégées les données transmises ?
Les informations ne servent qu'à l'étude de la demande et ne sont transmises qu'aux assureurs consultés. L'appel se fait en HTTPS, authentifié par clé API.
Un projet d'intégration ? Parlons-en.