Application Web & API pour développeurs

Omnillink

Une adresse en entrée, des données prêtes à l'emploi en sortie : une API qui écrit ses limites et joint ses mesures à chaque réponse.

Année
2026
Stack
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • Conception d'API
  • Développement back-end
  • Sécurité applicative
  • SDK et outils pour développeurs
  • Documentation
  • Site de présentation
https://omnillink.kayzen-lyon.com/
Page d'accueil du site Omnillink — Application Web & API pour développeurs, réalisé par KAYZEN
routes sous /api/v1, décrites dans le document OpenAPI 3.1
20
outils en lecture seule exposés aux agents IA par MCP
8
cookie et outil de mesure d'audience sur le site
0
licence du logiciel, à héberger soi-même
MIT
Le point de départ

Ce qu'il fallait résoudre.

Le contexte

Omnillink est une API éditée par KAYZEN depuis Lyon. On lui envoie l'adresse d'une page web publique ; elle renvoie ses métadonnées, une capture d'écran, un export PDF, des champs extraits sur mesure ou son contenu en Markdown. Le logiciel est distribué sous licence MIT et s'héberge soi-même. Le site omnillink.kayzen-lyon.com en est la démonstration, avec un bac à sable et une documentation en français et en anglais.

La contrainte

Afficher l'aperçu d'un lien, archiver une page en PDF ou donner le texte d'un article à un agent IA demande chaque fois le même travail : lire une page que l'on ne maîtrise pas, parfois construite en JavaScript, parfois protégée, sans exposer son propre réseau. Les API hébergées qui s'en chargent facturent à l'appel et voient passer les adresses lues. Il fallait un outil que l'on installe chez soi, dont les réglages et les limites soient écrits, et qui ne puisse pas être détourné pour atteindre un réseau interne.

La réponse

Une requête par besoin, et un chemin de lecture économe : la page est d'abord lue par une simple requête HTTP, et Chromium n'est lancé que si le résultat est pauvre ou si la page est une coquille d'application vide. Chaque adresse est validée contre les attaques SSRF avant toute connexion. Chaque réponse dit ce qui s'est passé : durée, mode de rendu, état du cache, identifiant de requête et quota restant. Le site suit la même règle : il n'affiche ni volumes ni témoignages, il montre des réponses réelles de l'API.

Design & direction artistique

Chaque parti pris, et sa raison.

  1. La démonstration est sur la page d'accueil

    Le visiteur saisit une adresse et lance une vraie requête depuis la page d'accueil, sans clé ni inscription. Un développeur juge une API à sa réponse : la lui montrer tout de suite, avec la durée, le mode de rendu et l'état du cache, lui évite de créer un compte pour se faire une idée.

  2. Chaque capacité est montrée avec sa vraie sortie

    Les cartes de fonctionnalités ne portent pas d'illustration : chacune affiche une réponse réelle de l'API, capturée sur une page de test, et mène à sa documentation et au bac à sable déjà réglé. Le lecteur voit le format exact qu'il recevra avant d'écrire une ligne de code.

  3. Des preuves plutôt que des chiffres

    Le produit vient d'être publié : un volume de requêtes ou un témoignage n'aurait aucune réalité. Le site n'en affiche donc pas. Une section liste à la place ce que chacun peut contrôler lui-même : le modèle de sécurité publié, les mesures jointes à chaque réponse, la licence et les limites retenues.

  4. Un bac à sable qui écrit le code

    Le bac à sable donne accès à tous les paramètres et génère le code de la requête en huit langages : curl, JavaScript, SDK TypeScript, Python, PHP, Go, Ruby et Rust. Le chemin entre l'essai et la première intégration se réduit à un copier-coller, sans passer par la lecture complète de la référence.

  5. La charte de KAYZEN, thème clair et thème sombre

    Outfit pour les titres, Plus Jakarta Sans pour le texte, bleu marine et terracotta pour l'action principale : le site reprend la charte de kayzen-lyon.com, pour que l'API soit identifiée comme un produit de l'agence. Le thème clair, le thème sombre ou celui du système se choisit dans les options d'affichage.

Système typographique

Titrage

Outfit

Texte courant

Plus Jakarta Sans

Les deux familles de kayzen-lyon.com, pour que l'API soit reconnue comme un produit de l'agence.

Ingénierie

Ce qu'il y a sous le capot.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. HTTP d'abord, navigateur seulement si nécessaire

    Lancer Chromium pour chaque page coûte du temps et de la mémoire. La page est donc d'abord lue par une requête HTTP et analysée ; le navigateur ne prend le relais que si le résultat est pauvre, si la page est une coquille d'application vide ou si le site a servi une page de blocage. Le champ meta.source indique le chemin suivi.

  2. Une protection SSRF à chaque connexion

    Une API qui visite des adresses fournies par l'appelant peut servir à atteindre un réseau interne. Les adresses privées, de bouclage et de métadonnées cloud sont refusées, et la résolution DNS est épinglée à la connexion. Dans le navigateur, tout le trafic sort par un proxy interne qui revalide chaque connexion, redirections comprises.

  3. Aucun code fourni par l'appelant n'est exécuté

    L'API n'exécute aucun script envoyé par le client. Ce qui précède une capture se décrit par des paramètres et des sélecteurs CSS : cliquer, faire défiler, attendre un élément. C'est une fonction en moins, et elle est voulue : du code arbitraire dans le navigateur contredirait l'isolation et la protection SSRF.

  4. Ni cookie ni identifiant transmis à la page lue

    L'appelant ne peut fixer que trois en-têtes : Accept-Language, User-Agent et Referer. Cookie et Authorization sont exclus, parce que les réponses sont mises en cache par adresse et servies à tous : une page obtenue avec la session d'un appelant serait servie au suivant.

  5. Cache, déduplication et disjoncteur par hôte

    Les résultats sont mis en cache, en mémoire ou dans Redis, et des requêtes identiques reçues en même temps ne déclenchent qu'un seul traitement. Un disjoncteur cesse de contacter un hôte après plusieurs échecs réseau consécutifs. Une page lente ou très demandée ne monopolise donc pas les navigateurs disponibles.

  6. Une référence OpenAPI tirée du code de validation

    Les paramètres du document OpenAPI 3.1 sont dérivés des schémas de validation des routes : la référence publiée décrit ce que le serveur accepte réellement. Chaque échec porte un code stable, de EINVALIDURL à ETIMEOUT, avec le statut HTTP correspondant, pour que le code client le traite sans analyser un message.

  7. Un point d'accès MCP pour les agents IA

    Huit outils en lecture seule sont exposés sur POST /mcp. Ils passent par les mêmes services que les routes REST, donc par les mêmes contrôles. Tout résultat qui porte du contenu de page commence par un avertissement : ce texte vient du web, c'est une donnée à évaluer et non une instruction à suivre.

  8. Une seule fonction sert l'API et le site

    Sur Vercel, le site est compilé puis intégré au bundle de l'API : une seule fonction répond à tout. Le budget de temps d'une requête est de 55 secondes par défaut, juste sous la durée maximale de la fonction (60 secondes), pour que l'API réponde elle-même par une erreur lisible plutôt que d'être interrompue par la plateforme.

Référencement

Comment le site se rend trouvable.

  1. Seize pages, chacune en français et en anglais

    Le plan de site déclare 32 adresses : accueil, bac à sable, référence de l'API, dix guides, état du service, accessibilité et mentions légales, en deux langues reliées par des balises hreflang. Un développeur cherche une réponse précise ; chaque sujet a donc sa propre page plutôt qu'une section d'une page unique.

  2. Des fichiers llms.txt pour les assistants

    Le site publie /llms.txt, qui liste la documentation avec une ligne de résumé par page, et /llms-full.txt, qui en donne le texte intégral. Un assistant de code interrogé sur l'API peut ainsi lire la documentation à jour au lieu de deviner des paramètres.

  3. Données structurées, et API tenue hors de l'exploration

    La page d'accueil déclare en JSON-LD l'éditeur, l'API (type WebAPI), le logiciel et sa foire aux questions. Le fichier robots.txt écarte /api/ de l'exploration : les réponses de l'API sont des données sur d'autres sites, pas des pages à indexer sous le nom d'Omnillink.

  4. Ni cookie ni mesure d'audience

    Le site ne dépose aucun cookie et ne charge aucun outil de mesure d'audience ; les préférences de thème, de langue et d'accessibilité restent dans le navigateur. Il n'y a donc pas de bandeau de consentement à passer avant de lire la documentation.

Accessibilité

Utilisable par tout le monde.

Depuis juin 2025, l'European Accessibility Act impose l'accessibilité numérique à une large part des services en ligne. Nous la traitons à la conception, pas en rattrapage.

  1. Un panneau d'options sur chaque page

    Un bouton ouvre les réglages d'affichage : taille du texte, contraste renforcé, police Atkinson Hyperlegible, interlignage, liens soulignés, animations réduites. Les choix sont enregistrés dans le navigateur et valent pour toutes les pages, sans dépendre des réglages du système.

  2. Ce qui a été vérifié, et ce qui ne l'a pas été

    La page Accessibilité liste les vérifications du 18 novembre 2026 : contrastes calculés pour les deux thèmes, parcours au clavier dans un navigateur piloté, absence de défilement horizontal à 375 pixels. Elle écrit aussi ce qui manque : aucun essai avec un lecteur d'écran, aucun audit WCAG ou RGAA par une personne formée. Le dire évite de laisser croire à une conformité qui n'a pas été établie.

Arborescence

Ce qui a été livré.

  • Accueil — démonstration en direct, capacités, fonctionnement, auto-hébergement, questions fréquentes
  • Bac à sable — tous les paramètres, code généré en huit langages
  • Référence de l'API — routes, paramètres, erreurs, quotas et cache
  • Guides — démarrage, auto-hébergement, SDK, agents IA, recettes, sécurité, limites
  • État du service
  • Accessibilité, mentions légales et confidentialité
Méthode

Le déroulé du projet.

  1. API de base

    Métadonnées, capture d'écran, PDF, extraction et contenu lisible ; validation des adresses, cache et déploiement en une seule fonction sur Vercel.

  2. Durcissement

    Proxy interne qui valide chaque connexion du navigateur, redirections comprises ; paramètres inconnus ignorés plutôt que refusés.

  3. Outils pour développeurs

    SDK TypeScript, ligne de commande, serveur MCP, composant React, action GitHub et exemples d'intégration.

  4. Site et publication

    Bac à sable, guides, recherche, version anglaise, point d'accès MCP hébergé et journal des modifications ; mise en ligne en novembre 2026.

Questions

Ce qu'on nous demande souvent.

Le logiciel est distribué sous licence MIT : on peut l'utiliser, le modifier et l'héberger soi-même, sans coût par requête autre que son propre hébergement. L'instance qui sert le site est une démonstration, avec une limite de débit.

Non. L'API répond sans authentification. L'en-tête facultatif x-api-key relève la limite de débit, et les clés sont définies par l'exploitant de chaque instance. Par défaut, la limite est de 60 requêtes par fenêtre sans clé et de 600 avec une clé.

Les pages publiques en http ou https. Les adresses privées, locales ou internes sont refusées par la protection SSRF. Les pages construites en JavaScript sont rendues dans Chromium quand c'est nécessaire. Si un site répond par une page de blocage, l'API le signale par une erreur au lieu de renvoyer cette page comme un contenu.

Node.js 22 ou plus récent, et Chromium, installé par Playwright. Redis est facultatif : sans lui, le cache et les compteurs de quota vivent en mémoire, instance par instance. L'exploitation reste à la charge de celui qui héberge : mises à jour, Chromium, supervision.

Le même niveau d'exigence, pour votre site.

Audit gratuit de votre site actuel, devis sous 24 h et un raisonnement écrit — comme celui que vous venez de lire. Paiement en trois fois sans frais, aides locales vérifiées avant signature.

Partager