Webapplicatie & API voor ontwikkelaars

Omnillink

Een adres als invoer, gegevens klaar voor gebruik als uitvoer: een API die haar grenzen opschrijft en haar metingen bij elk antwoord voegt.

Jaar
2026
Stack
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • API-ontwerp
  • Back-endontwikkeling
  • Applicatiebeveiliging
  • SDK en tools voor ontwikkelaars
  • Documentatie
  • Presentatiesite
https://omnillink.kayzen-lyon.com/
Homepage van de website Omnillink — Webapplicatie & API voor ontwikkelaars, gemaakt door KAYZEN
routes onder /api/v1, beschreven in het OpenAPI 3.1-document
20
alleen-lezen-tools die via MCP aan AI-agents worden aangeboden
8
cookies en tools voor bezoekersmeting op de site
0
licentie van de software, om zelf te hosten
MIT
Het uitgangspunt

Wat er opgelost moest worden.

De context

Omnillink is een API die KAYZEN vanuit Lyon uitgeeft. U stuurt het adres van een openbare webpagina; de API geeft de metadata, een screenshot, een PDF-export, op maat geëxtraheerde velden of de inhoud in Markdown terug. De software wordt verspreid onder de MIT-licentie en host u zelf. De site omnillink.kayzen-lyon.com is de demonstratie ervan, met een sandbox en documentatie in het Frans en het Engels.

De beperking

De preview van een link tonen, een pagina als PDF archiveren of de tekst van een artikel aan een AI-agent geven vraagt telkens hetzelfde werk: een pagina lezen die u niet beheert, soms opgebouwd in JavaScript, soms afgeschermd, zonder uw eigen netwerk bloot te stellen. De gehoste API's die dat doen, rekenen per aanroep af en zien de gelezen adressen voorbijkomen. Er was een tool nodig die u bij uzelf installeert, waarvan de instellingen en de grenzen zijn opgeschreven, en die niet kan worden misbruikt om een intern netwerk te bereiken.

Het antwoord

Eén verzoek per behoefte, en een zuinig leespad: de pagina wordt eerst met een eenvoudig HTTP-verzoek gelezen, en Chromium wordt alleen gestart als het resultaat mager is of als de pagina een lege applicatieschil is. Elk adres wordt vóór elke verbinding gevalideerd tegen SSRF-aanvallen. Elk antwoord zegt wat er is gebeurd: duur, rendermodus, cachestatus, verzoek-ID en resterend quotum. De site volgt dezelfde regel: hij toont geen volumes en geen getuigenissen, maar echte antwoorden van de API.

Design & art direction

Elke keuze, en de reden erachter.

  1. De demo staat op de homepage

    De bezoeker voert een adres in en start vanaf de homepage een echt verzoek, zonder sleutel of registratie. Een ontwikkelaar beoordeelt een API op haar antwoord: door dat meteen te tonen, met de duur, de rendermodus en de cachestatus, hoeft hij geen account aan te maken om zich een beeld te vormen.

  2. Elke mogelijkheid wordt getoond met haar echte uitvoer

    De functiekaarten hebben geen illustratie: elke kaart toont een echt antwoord van de API, vastgelegd op een testpagina, en leidt naar de bijbehorende documentatie en naar de al ingestelde sandbox. De lezer ziet het exacte formaat dat hij zal ontvangen voordat hij één regel code schrijft.

  3. Bewijzen in plaats van cijfers

    Het product is net gepubliceerd: een aantal verzoeken of een getuigenis zou geen enkele werkelijkheid weergeven. De site toont ze dus niet. In plaats daarvan somt een sectie op wat iedereen zelf kan controleren: het gepubliceerde beveiligingsmodel, de metingen bij elk antwoord, de licentie en de gekozen grenzen.

  4. Een sandbox die de code schrijft

    De sandbox geeft toegang tot alle parameters en genereert de code van het verzoek in acht talen: curl, JavaScript, TypeScript-SDK, Python, PHP, Go, Ruby en Rust. De weg van de proef naar de eerste integratie beperkt zich tot kopiëren en plakken, zonder de volledige referentie te hoeven lezen.

  5. De huisstijl van KAYZEN, licht en donker thema

    Outfit voor de titels, Plus Jakarta Sans voor de tekst, marineblauw en terracotta voor de hoofdactie: de site neemt de huisstijl van kayzen-lyon.com over, zodat de API wordt herkend als een product van het bureau. Het lichte thema, het donkere thema of dat van het systeem kiest u in de weergaveopties.

Typografisch systeem

Koppen

Outfit

Lopende tekst

Plus Jakarta Sans

De twee lettertypefamilies van kayzen-lyon.com, zodat de API wordt herkend als een product van het bureau.

Engineering

Wat er onder de motorkap zit.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. Eerst HTTP, de browser alleen als het nodig is

    Chromium starten voor elke pagina kost tijd en geheugen. De pagina wordt daarom eerst met een HTTP-verzoek gelezen en geanalyseerd; de browser neemt het alleen over als het resultaat mager is, als de pagina een lege applicatieschil is of als de site een blokkeerpagina heeft geserveerd. Het veld meta.source geeft het gevolgde pad aan.

  2. SSRF-bescherming bij elke verbinding

    Een API die adressen bezoekt die de aanroeper opgeeft, kan worden gebruikt om een intern netwerk te bereiken. Privéadressen, loopbackadressen en adressen van cloudmetadata worden geweigerd, en de DNS-resolutie wordt aan de verbinding vastgepind. In de browser gaat al het verkeer naar buiten via een interne proxy die elke verbinding opnieuw valideert, ook bij redirects.

  3. Er wordt geen code van de aanroeper uitgevoerd

    De API voert geen enkel script uit dat de client meestuurt. Wat aan een screenshot voorafgaat, wordt beschreven met parameters en CSS-selectors: klikken, scrollen, wachten op een element. Dat is één functie minder, en dat is bewust: willekeurige code in de browser zou in strijd zijn met de isolatie en de SSRF-bescherming.

  4. Geen cookie en geen inloggegevens naar de gelezen pagina

    De aanroeper kan slechts drie headers instellen: Accept-Language, User-Agent en Referer. Cookie en Authorization zijn uitgesloten, omdat de antwoorden per adres in de cache worden bewaard en aan iedereen worden geserveerd: een pagina die met de sessie van de ene aanroeper is opgehaald, zou aan de volgende worden geserveerd.

  5. Cache, deduplicatie en circuit breaker per host

    De resultaten worden in de cache bewaard, in het geheugen of in Redis, en identieke verzoeken die tegelijk binnenkomen, starten maar één verwerking. Een circuit breaker neemt geen contact meer op met een host na meerdere opeenvolgende netwerkfouten. Een trage of veelgevraagde pagina legt dus geen beslag op de beschikbare browsers.

  6. Een OpenAPI-referentie afgeleid uit de validatiecode

    De parameters van het OpenAPI 3.1-document zijn afgeleid van de validatieschema's van de routes: de gepubliceerde referentie beschrijft wat de server werkelijk accepteert. Elke fout heeft een stabiele code, van EINVALIDURL tot ETIMEOUT, met de bijbehorende HTTP-status, zodat de clientcode de fout kan afhandelen zonder een bericht te ontleden.

  7. Een MCP-eindpunt voor AI-agents

    Acht alleen-lezen-tools zijn beschikbaar op POST /mcp. Ze lopen via dezelfde services als de REST-routes, en dus via dezelfde controles. Elk resultaat dat pagina-inhoud bevat, begint met een waarschuwing: deze tekst komt van het web, het is een gegeven om te beoordelen en geen instructie om op te volgen.

  8. Eén functie bedient de API en de site

    Op Vercel wordt de site gecompileerd en daarna in de bundel van de API opgenomen: één functie beantwoordt alles. Het tijdsbudget van een verzoek is standaard 55 seconden, net onder de maximale duur van de functie (60 seconden), zodat de API zelf met een leesbare fout antwoordt in plaats van door het platform te worden afgebroken.

Vindbaarheid

Hoe de website vindbaar wordt.

  1. Zestien pagina's, elk in het Frans en het Engels

    De sitemap vermeldt 32 adressen: homepage, sandbox, API-referentie, tien gidsen, servicestatus, toegankelijkheid en juridische vermeldingen, in twee talen die met hreflang-tags aan elkaar zijn gekoppeld. Een ontwikkelaar zoekt een precies antwoord; elk onderwerp heeft daarom zijn eigen pagina in plaats van een sectie op één enkele pagina.

  2. llms.txt-bestanden voor assistenten

    De site publiceert /llms.txt, dat de documentatie opsomt met één samenvattende regel per pagina, en /llms-full.txt, dat de volledige tekst ervan geeft. Een code-assistent die een vraag over de API krijgt, kan zo de actuele documentatie lezen in plaats van parameters te raden.

  3. Gestructureerde gegevens, en de API buiten het crawlen gehouden

    De homepage declareert in JSON-LD de uitgever, de API (type WebAPI), de software en de veelgestelde vragen. Het bestand robots.txt sluit /api/ uit van het crawlen: de antwoorden van de API zijn gegevens over andere sites, geen pagina's om onder de naam Omnillink te indexeren.

  4. Geen cookies en geen bezoekersmeting

    De site plaatst geen enkele cookie en laadt geen enkele tool voor bezoekersmeting; de voorkeuren voor thema, taal en toegankelijkheid blijven in de browser. Er is dus geen toestemmingsbanner die u moet wegklikken voordat u de documentatie leest.

Toegankelijkheid

Bruikbaar voor iedereen.

Sinds juni 2025 verplicht de Europese toegankelijkheidsrichtlijn (European Accessibility Act) digitale toegankelijkheid voor een groot deel van de onlinediensten. Wij regelen dat in het ontwerp, niet achteraf.

  1. Een optiepaneel op elke pagina

    Een knop opent de weergave-instellingen: tekstgrootte, versterkt contrast, lettertype Atkinson Hyperlegible, regelafstand, onderstreepte links, verminderde animaties. De keuzes worden in de browser opgeslagen en gelden voor alle pagina's, los van de systeeminstellingen.

  2. Wat is gecontroleerd, en wat niet

    De pagina Toegankelijkheid somt de controles van 18 november 2026 op: contrasten berekend voor beide thema's, toetsenbordnavigatie in een aangestuurde browser, geen horizontaal scrollen bij 375 pixels. Ze schrijft ook op wat ontbreekt: geen test met een schermlezer, geen WCAG- of RGAA-audit door een opgeleide persoon. Door dat te zeggen, wordt niet de indruk gewekt van een conformiteit die niet is vastgesteld.

Sitestructuur

Wat er is opgeleverd.

  • Homepage — live demo, mogelijkheden, werking, zelf hosten, veelgestelde vragen
  • Sandbox — alle parameters, code gegenereerd in acht talen
  • API-referentie — routes, parameters, fouten, quota en cache
  • Gidsen — aan de slag, zelf hosten, SDK, AI-agents, recepten, beveiliging, grenzen
  • Servicestatus
  • Toegankelijkheid, juridische vermeldingen en privacy
Werkwijze

Het verloop van het project.

  1. Basis-API

    Metadata, screenshot, PDF, extractie en leesbare inhoud; validatie van adressen, cache en deployment in één functie op Vercel.

  2. Hardening

    Interne proxy die elke verbinding van de browser valideert, ook bij redirects; onbekende parameters worden genegeerd in plaats van geweigerd.

  3. Tools voor ontwikkelaars

    TypeScript-SDK, opdrachtregel, MCP-server, React-component, GitHub-actie en integratievoorbeelden.

  4. Site en publicatie

    Sandbox, gidsen, zoekfunctie, Engelse versie, gehost MCP-eindpunt en wijzigingslogboek; online gezet in november 2026.

Vragen

Wat ons vaak gevraagd wordt.

De software wordt verspreid onder de MIT-licentie: u mag hem gebruiken, aanpassen en zelf hosten, zonder andere kosten per verzoek dan uw eigen hosting. De instantie die de site bedient, is een demonstratie, met een verzoeklimiet.

Nee. De API antwoordt zonder authenticatie. De optionele header x-api-key verhoogt de verzoeklimiet, en de sleutels worden bepaald door de beheerder van elke instantie. Standaard is de limiet 60 verzoeken per venster zonder sleutel en 600 met een sleutel.

Openbare pagina's via http of https. Privéadressen, lokale of interne adressen worden geweigerd door de SSRF-bescherming. Pagina's die in JavaScript zijn opgebouwd, worden in Chromium gerenderd wanneer dat nodig is. Als een site met een blokkeerpagina antwoordt, meldt de API dat met een fout in plaats van die pagina als inhoud terug te geven.

Node.js 22 of recenter, en Chromium, geïnstalleerd door Playwright. Redis is optioneel: zonder Redis leven de cache en de quotumtellers in het geheugen, per instantie. Het beheer blijft de verantwoordelijkheid van wie host: updates, Chromium, monitoring.

Hetzelfde niveau van zorg, voor uw website.

Gratis audit van uw huidige website, offerte binnen 24 uur en een schriftelijke onderbouwing — zoals die u net hebt gelezen. Betaling in drie termijnen zonder extra kosten; lokale subsidies gecontroleerd vóór ondertekening.

Delen