Développeurs

Le catalogue Dinilu, les prix actuels et les devis de transport sont accessibles aux logiciels, pas uniquement aux personnes. Deux interfaces servent les mêmes données : un serveur Model Context Protocol pour les assistants IA, et une API REST JSON classique pour tout le reste. Les deux sont publiques, en lecture seule, et ne demandent ni clé ni inscription.

Model Context Protocol

Si votre client parle MCP, privilégiez-le. Les arguments des outils sont en JSON : rien n'a besoin d'être comprimé dans une chaîne de requête.

Le point d'accès est /mcp sur ce domaine, JSON-RPC 2.0 en POST. Il est sans état et n'ouvre pas de flux SSE.

Trois outils sont publiés :

  • search_products — trouver des produits par texte libre, par catégorie, ou les deux.
  • get_product — les attributs configurables d'un produit et leurs options, sa quantité minimale de commande et son pas de quantité.
  • get_quote — chiffrer une configuration et une quantité précises, avec le délai de production et les options d'expédition.

Chaque domaine et chaque langue est un point d'accès distinct, avec son propre catalogue, ses propres prix et sa propre devise. Connectez-vous à celui du marché visé plutôt que de traduire les résultats vous-même.

Connecter un assistant

Le point d'accès est une URL HTTPS publique et ne demande aucune clé : la plupart des clients n'ont besoin que de l'adresse.

https://dinilu.ch/frmcp

  • Claude — Paramètres → Connecteurs → Ajouter un connecteur personnalisé, puis collez l'URL. Sur les formules Team et Enterprise, un administrateur peut l'ajouter une seule fois pour tout le monde depuis les paramètres de l'organisation.
  • ChatGPT — activez le mode développeur dans Settings → Apps, puis créez une app pointant vers l'URL.
  • Cursor, VS Code et autres éditeurs — ajoutez {"url": "https://dinilu.ch/frmcp"} à votre configuration MCP.

Chaque domaine Dinilu est un point d'accès distinct, avec son propre catalogue, ses prix, sa devise et ses modes d'expédition. Utilisez celui du marché que vous chiffrez.

API REST JSON

  • GET /api/products — tous les produits disponibles sur ce domaine, dans cette langue.
  • GET /api/product/{mpn} — les attributs, options, quantités de commande et images d'un produit.
  • GET /api/quote?mpn={mpn}&qty={qty}&attributes={config} — un prix actuel, le délai de production et les options d'expédition.

Trouver un numéro de produit

Chaque fiche produit contient son MPN dans ses données structurées JSON-LD, et pointe vers son propre JSON via une balise <link rel="alternate" type="application/json"> dans l'en-tête de la page. Vous pouvez aussi lister et interroger le catalogue.

Configurer un devis

Les options se choisissent par id : attributes={id attribut}:{id option}, les paires étant séparées par |. Les deux ids proviennent de get_product. Les noms d'options sont également acceptés, mais ils sont traduits par domaine et doivent correspondre exactement : les ids sont donc la forme fiable. Chaque réponse produit contient un exemple exécutable.

Ce que signifient les chiffres

  • Les devis sont indicatifs et non contractuels. Ils sont calculés en direct à partir des coûts, taux de change et tarifs de fret actuels, et la réponse le précise.
  • Les prix s'entendent à la pièce et hors TVA, dans la devise du domaine appelé.
  • Chaque option d'expédition est chiffrée séparément. L'entité juridique vendeuse dépend du mode d'expédition et non du domaine : chaque option indique donc son propre fournisseur.
  • Les quantités minimales de commande sont réelles. Une quantité inférieure est relevée, et la réponse renvoie un avertissement à ce sujet.

Chaque réponse contient un tableau warnings. Il mérite d'être lu : c'est là que l'API signale qu'une quantité a été ajustée, qu'une option a reçu une valeur par défaut, ou qu'un pays n'a pas pu être identifié.

Usage raisonnable

Il n'y a ni clé d'API ni limite stricte. Restez raisonnable : mettez en cache ce qui ne change pas, et ne parcourez pas le catalogue plus souvent qu'il n'évolue. Pour un accès en volume, un débit garanti ou une intégration commerciale, utilisez le formulaire de contact en précisant ce que vous construisez.

Index lisible par machine

/llms.txt est un résumé court destiné aux assistants IA, et /llms-full.txt documente le parcours complet avec des exemples détaillés. Les deux sont générés par domaine et par langue.

Questions

Les questions d'intégration, les rapports d'anomalie et les demandes d'évolution sont les bienvenus via le formulaire de contact.