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

- 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
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.
Elke keuze, en de reden erachter.
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.
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.
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.
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.
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.
Wat er onder de motorkap zit.
- TypeScript
- Node.js
- Fastify
- Playwright
- Redis
- Tailwind
- Vercel
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.
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.
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.
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.
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.
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.
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.
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.
Hoe de website vindbaar wordt.
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.
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.
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.
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.
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.
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.
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.
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
Het verloop van het project.
Basis-API
Metadata, screenshot, PDF, extractie en leesbare inhoud; validatie van adressen, cache en deployment in één functie op Vercel.
Hardening
Interne proxy die elke verbinding van de browser valideert, ook bij redirects; onbekende parameters worden genegeerd in plaats van geweigerd.
Tools voor ontwikkelaars
TypeScript-SDK, opdrachtregel, MCP-server, React-component, GitHub-actie en integratievoorbeelden.
Site en publicatie
Sandbox, gidsen, zoekfunctie, Engelse versie, gehost MCP-eindpunt en wijzigingslogboek; online gezet in november 2026.
Wat ons vaak gevraagd wordt.
Andere projecten
Webapplicatie & kunstmatige intelligentieStudio AI
Achttien AI-foto- en videotools, elk met de vermelding of ze in de browser of online draaien: privacy wordt een vinkje, geen belofte.
Webapplicatie & SEOKayzen Trust
Een linkindicator met een gepubliceerde methode: vertrouwen is meetbaar, en het verschil met populariteit verraadt gekochte links.
Vrije software & DesktopapplicatieKAYZEN Flux
Een converter zonder server: het bestand verlaat de computer nooit, en de code is openbaar zodat u dat kunt controleren.
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.