Comparer et demander une offre depuis votre assistant IA

Protocole v2 en quatre étapes

1. Calcul : POST https://api.assurs.ch/api/v1/lamal/quote (GET accepté) avec premium_year, postal_code, birth_year, deductible_chf, accident_included (booléen), model_group (any ou une catégorie OFSP), municipality ou municipality_bfs si le NPA l’exige, language. La réponse contient offers[], cashback (statut, montant, client_sentence fr/de/it/en, terms_url) et submission : request_id (UUID prêt à l’emploi), comparison_id, endpoint, test_endpoint, request_template, client_messages.consent_request, instructions, on_error.
2. Présentation : primes officielles, sources, puis cashback.client_sentence ; demander l’offre retenue et le moyen de contact.
3. Consentement : lire consent_request en remplaçant {fields}, {insurer}, {model}, {premium} ; n’envoyer qu’après un oui explicite.
4. Envoi : POST https://api.assurs.ch/api/v1/lamal/offer-requests avec le corps ci-dessous, puis rapporter le reçu.

{
  "request_id": "d3b4…",
  "comparison_id": "<submission.comparison_id du calcul>",
  "insurer_id": 1509,
  "language": "fr",
  "contact": { "name": "", "email": "client@example.ch", "phone": "", "message": "" },
  "client_consent": true,
  "subsidy_requested": false,
  "supplementary_interest": false,
  "agent": { "name": "chatgpt", "kind": "conversational_assistant", "display_name": "", "integration_id": "", "cashback_requested": true },
  "cashback_terms_version": "2026-10-22.1"
}

request_id : réutiliser submission.request_id du calcul (tout UUID RFC 4122 est accepté) et le conserver avec le même contenu pour toute reprise. comparison_id remplace le renvoi des critères et du jeton : le serveur rouvre la référence, valable 30 jours et insensible aux redémarrages. L’ancienne paire comparison + comparison_token reste acceptée (jeton valable 24 heures, lié aux prix et au jeu de données). insurer_id doit être un offers[].insurer_id du calcul ; offer_id est accepté à la place. contact : e-mail ou téléphone obligatoire, nom et message facultatifs ; dans request_template ces champs sont des chaînes vides : remplir email ou phone et laisser l’autre vide (les valeurs littérales <…> sont ignorées). La route réelle vérifie en plus que le domaine de l’e-mail accepte le courrier (invalid_email_domain). client_consent doit être true. agent, subsidy_requested, supplementary_interest et cashback_terms_version sont facultatifs.

Test sans e-mail : POST https://api.assurs.ch/api/v1/lamal/offer-requests/test, même corps, coordonnées fictives uniquement. Reçu status: "validated_test", email_sent: false, payment_created: false et un aperçu (preview) de ce qui serait envoyé. Aucun e-mail, lead, droit ou paiement n’est créé. Le test ne consomme pas le quota d’envoi réel et ne vérifie pas le domaine de l’e-mail.

Reçu réel : status: "accepted", request_id, email_sent: true, recipient, accepted_at, cashback (program_status, lamal_amount_chf, contract_status: "not_verified", payment_created: false, terms_url, next_steps) et correction_or_cancellation. Accepté pour livraison à SPI : ni preuve de réception en boîte, ni contrat.

Erreurs (enveloppe v2)

Toute erreur des routes v2 renvoie { "status": "error", "code", "errors": [{ "field", "message", "choices"? }], "guidance", "retryable", "retry_after_seconds"? }. retryable n’est vrai que pour rate_limited (429), 502 et 503.

Limites : calcul 120 appels/min/IP et 1 200/min au total ; envois réels 60/h/IP, 3 par jour et par contact, 200 par jour au total ; tests 60/h/IP, compteur distinct. Les doublons d’un même request_id sont dédupliqués pendant 24 heures.

Routes historiques

POST https://api.assurs.ch/api/lamal/v1/offer-requests et /offer-requests/test (corps camelCase : requestId, comparison, comparisonToken, insurerId, clientConsent, agentContext) restent disponibles sans changement, avec l’enveloppe d’erreur {ok:false, code}. Les routes v2 acceptent aussi ce corps historique (détecté par requestId). Les nouvelles intégrations utilisent les routes v2.

Connexion MCP

URL du serveur : https://api.assurs.ch/mcp. Transport Streamable HTTP, réponses JSON, sans session persistante. Les outils d’envoi utilisent les routes v2 et le corps ci-dessus. Une erreur d’outil revient en isError:true avec l’enveloppe v2 et http_status. Le serveur expose aussi le prompt lamal_compare_and_contact et les ressources docs://assurs/llms.txt, docs://assurs/skill.md, docs://assurs/cashback-terms, docs://assurs/privacy, docs://assurs/terms.

Contrats, skill et fichiers d’intégration

• openapi.json : contrat allégé, six opérations (prepareLamalQuote, getLamalMetadata, getActiveCustomerRewards, testOfferRequest, submitOfferRequest, createAdviserHandoffLink), à importer dans les Actions ou Muse. openapi-full.json : toutes les opérations, y compris les routes historiques.
• Skill assurs-lamal (format agentskills.io) pour OpenClaw, Codex, Claude Code, Cursor et Copilot ; référence détaillée dans references/protocol.md.
• integrations/ : server.json du registre MCP, extension Gemini, manifeste Codex, mcp.json Claude Code, extrait OpenClaw, déclarations d’outils pour les API OpenAI Responses, xAI, Gemini et Anthropic Messages.
• llms.txt, llms-full.txt, .well-known/mcp.json, .well-known/ai-catalog.json.

Le mode public n’exige aucune clé. Ne jamais fournir au client le secret de liens, la clé Resend ou les variables privées Render. Si l’opérateur active un mode réservé aux intégrations, fournir uniquement la clé d’intégration autorisée dans l’en-tête Authorization.

Trois accès directs à tester

Profil de démonstration : Chamoson 1955, naissance 1988, année 2027, télémédecine TEL_DIG, franchise CHF 2’500. L’exclusion de l’accident est uniquement une hypothèse explicite de test ; demander ce choix au client réel.

1. Calculer les primes en JSON compact, par GET.
2. Lire les mêmes résultats en HTML, sans JavaScript.
3. Lire le statut actuel et les conditions des programmes, ou la page des conditions du cashback. Une publication commerciale de l’opérateur ne prouve pas une validation juridique indépendante ni l’éligibilité du client. La prime officielle reste inchangée.

Ce document ne fige aucun prix ou montant promotionnel. Lire les réponses du service, leurs sources, leur date de validation et leurs limites. Le JSON compact contient les dix meilleurs résultats par assureur ainsi que tous les modèles admissibles importés ; full_response_url donne les preuves détaillées. Le HTML partagé ne contient aucune promotion cashback. Conserver l’année de naissance exacte ; utiliser model_group=any si le client veut le moins cher toutes catégories, et demander son choix concernant les accidents. Un GET ne peut jamais envoyer de demande, et les coordonnées ne doivent pas être ajoutées aux liens. Sans outil POST autorisé, proposer le adviser_url retourné pour que le client confirme dans le formulaire.

Si un accès échoue

Un succès HTTP depuis un réseau ne garantit pas l’accès depuis celui d’un éditeur d’IA. Un environnement de programmation sans réseau ne peut pas appeler l’API. Le premier appel d’une session peut être lent si le service redémarre. Pour un échec de navigation, conserver l’URL, l’heure UTC et le message exact ; comparer avec un accès HTTP externe et les journaux CDN. Une connexion MCP ou Action doit être testée dans l’application concernée avant d’être annoncée opérationnelle.

GPT Actions · MCP OpenAI · Connecteurs Claude · MCP Gemini CLI · Spécification des skills

Documentation complète · Métadonnées · Confidentialité · Conditions · Comparateur officiel