Ontwikkelaars

De catalogus van Dinilu, actuele prijzen en verzendofferten zijn beschikbaar voor software, niet alleen voor mensen. Twee interfaces leveren dezelfde gegevens: een Model Context Protocol-server voor AI-assistenten, en een gewone JSON REST API voor al het overige. Beide zijn openbaar, alleen-lezen, en vereisen geen sleutel of registratie.

Model Context Protocol

Spreekt uw client MCP, gebruik die dan bij voorkeur. Toolargumenten zijn JSON, dus niets hoeft in een query string geperst te worden.

Het eindpunt is /mcp op dit domein, JSON-RPC 2.0 via POST. Het is stateless en opent geen SSE-stream.

Er zijn drie tools:

  • search_products — vind producten op vrije tekst, op categorie, of beide.
  • get_product — de instelbare attributen van een product en hun opties, de minimale bestelhoeveelheid en de stapgrootte.
  • get_quote — bereken de prijs van een specifieke configuratie en hoeveelheid, met productietijd en verzendopties.

Elk domein en elke taal is een apart eindpunt, met een eigen assortiment, eigen prijzen en eigen valuta. Verbind met het eindpunt van de markt die u wilt, in plaats van de resultaten zelf te vertalen.

Een assistent verbinden

Het eindpunt is een openbare HTTPS-URL en vereist geen sleutel, dus de meeste clients hebben alleen het adres nodig:

https://dinilu.be/mcp

  • Claude — Instellingen → Connectors → Aangepaste connector toevoegen, en plak de URL. Bij Team- en Enterprise-abonnementen kan een beheerder de connector één keer voor iedereen toevoegen onder de organisatie-instellingen.
  • ChatGPT — schakel de ontwikkelaarsmodus in onder Settings → Apps en maak vervolgens een app die naar de URL verwijst.
  • Cursor, VS Code en andere editors — voeg {"url": "https://dinilu.be/mcp"} toe aan uw MCP-configuratie.

Elk Dinilu-domein is een eigen eindpunt, met een eigen assortiment, eigen prijzen, eigen valuta en eigen verzendmethoden. Gebruik het domein van de markt waarvoor u offreert.

JSON REST API

  • GET /api/products — alle producten die op dit domein in deze taal beschikbaar zijn.
  • GET /api/product/{mpn} — de attributen, opties, bestelhoeveelheden en afbeeldingen van één product.
  • GET /api/quote?mpn={mpn}&qty={qty}&attributes={config} — een actuele prijs, productietijd en verzendopties.

Een productnummer vinden

Elke productpagina bevat zijn MPN in de JSON-LD structured data, en verwijst naar zijn eigen JSON via een <link rel="alternate" type="application/json">-tag in de head van de pagina. U kunt de catalogus ook opvragen en doorzoeken.

Een offerte configureren

Opties kiest u op id: attributes={attribuut id}:{optie id}, met paren gescheiden door |. Beide ids komen uit get_product. Optienamen worden ook geaccepteerd, maar die zijn per domein vertaald en moeten exact overeenkomen, dus ids zijn de betrouwbare vorm. Elk productantwoord bevat een uitvoerbaar voorbeeld.

Wat de getallen betekenen

  • Offertes zijn indicatief, niet bindend. Ze worden live berekend op basis van actuele kosten, wisselkoersen en vrachttarieven, en het antwoord vermeldt dat.
  • Prijzen zijn per stuk en exclusief btw, in de valuta van het domein dat u aanroept.
  • Verzendopties worden afzonderlijk geprijsd. De verkopende juridische entiteit volgt de verzendmethode en niet het domein, dus elke optie vermeldt zijn eigen leverancier.
  • Minimale bestelhoeveelheden zijn reëel. Een lagere hoeveelheid wordt naar boven bijgesteld en het antwoord geeft daar een waarschuwing over.

Elk antwoord bevat een warnings-array. Die is het lezen waard: daar meldt de API dat een hoeveelheid is aangepast, dat een optie met een standaardwaarde is ingevuld, of dat een land niet herkend kon worden.

Redelijk gebruik

Er is geen API-sleutel en geen harde limiet. Wees redelijk — cache wat niet verandert, en doorloop de catalogus niet vaker dan die verandert. Heeft u volumetoegang, een gegarandeerde snelheid of een commerciële integratie nodig, gebruik dan het contactformulier en vertel wat u bouwt.

Machineleesbare index

/llms.txt is een korte samenvatting voor AI-assistenten, en /llms-full.txt documenteert de volledige aanvraagstroom met uitgewerkte voorbeelden. Beide worden per domein en per taal gegenereerd.

Vragen

Vragen over integratie, foutmeldingen en wensen zijn welkom via het contactformulier.