Aplicação Web & API para programadores

Omnillink

Um endereço à entrada, dados prontos a usar à saída: uma API que escreve os seus limites e junta as suas medições a cada resposta.

Ano
2026
Stack
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • Conceção de API
  • Desenvolvimento back-end
  • Segurança aplicacional
  • SDK e ferramentas para programadores
  • Documentação
  • Site de apresentação
https://omnillink.kayzen-lyon.com/
Página inicial do site Omnillink — Aplicação Web & API para programadores, realizado pela KAYZEN
rotas em /api/v1, descritas no documento OpenAPI 3.1
20
ferramentas só de leitura expostas aos agentes de IA por MCP
8
cookies e ferramentas de medição de audiência no site
0
licença do software, para alojar por conta própria
MIT
O ponto de partida

O que era preciso resolver.

O contexto

O Omnillink é uma API editada pela KAYZEN a partir de Lyon. Envia-se-lhe o endereço de uma página web pública; ela devolve os seus metadados, uma captura de ecrã, uma exportação em PDF, campos extraídos à medida ou o seu conteúdo em Markdown. O software é distribuído sob licença MIT e aloja-se por conta própria. O site omnillink.kayzen-lyon.com é a sua demonstração, com uma área de testes e documentação em francês e em inglês.

A restrição

Mostrar a pré-visualização de uma ligação, arquivar uma página em PDF ou dar o texto de um artigo a um agente de IA exige sempre o mesmo trabalho: ler uma página que não se controla, por vezes construída em JavaScript, por vezes protegida, sem expor a própria rede. As API alojadas que tratam disso faturam por chamada e veem passar os endereços lidos. Era preciso uma ferramenta que se instala em casa, cujas definições e limites estejam escritos, e que não possa ser desviada para alcançar uma rede interna.

A resposta

Um pedido por necessidade, e um caminho de leitura económico: a página é lida primeiro por um simples pedido HTTP, e o Chromium só é lançado se o resultado for pobre ou se a página for uma casca de aplicação vazia. Cada endereço é validado contra ataques SSRF antes de qualquer ligação. Cada resposta diz o que aconteceu: duração, modo de renderização, estado da cache, identificador do pedido e quota restante. O site segue a mesma regra: não apresenta volumes nem testemunhos, mostra respostas reais da API.

Design & direção artística

Cada opção, e a sua razão.

  1. A demonstração está na página inicial

    O visitante introduz um endereço e lança um pedido real a partir da página inicial, sem chave nem registo. Um programador avalia uma API pela sua resposta: mostrá-la de imediato, com a duração, o modo de renderização e o estado da cache, poupa-lhe a criação de uma conta só para formar uma opinião.

  2. Cada capacidade é mostrada com a sua saída real

    Os cartões de funcionalidades não têm ilustração: cada um apresenta uma resposta real da API, capturada numa página de teste, e conduz à respetiva documentação e à área de testes já configurada. O leitor vê o formato exato que vai receber antes de escrever uma linha de código.

  3. Provas em vez de números

    O produto acaba de ser publicado: um volume de pedidos ou um testemunho não teria qualquer realidade. O site, por isso, não os apresenta. Em vez disso, uma secção enumera o que cada um pode verificar por si: o modelo de segurança publicado, as medições juntas a cada resposta, a licença e os limites adotados.

  4. Uma área de testes que escreve o código

    A área de testes dá acesso a todos os parâmetros e gera o código do pedido em oito linguagens: curl, JavaScript, SDK TypeScript, Python, PHP, Go, Ruby e Rust. O caminho entre o ensaio e a primeira integração reduz-se a copiar e colar, sem passar pela leitura completa da referência.

  5. A identidade gráfica da KAYZEN, tema claro e tema escuro

    Outfit para os títulos, Plus Jakarta Sans para o texto, azul-marinho e terracota para a ação principal: o site retoma a identidade gráfica de kayzen-lyon.com, para que a API seja identificada como um produto da agência. O tema claro, o tema escuro ou o do sistema escolhe-se nas opções de visualização.

Sistema tipográfico

Títulos

Outfit

Texto corrido

Plus Jakarta Sans

As duas famílias de kayzen-lyon.com, para que a API seja reconhecida como um produto da agência.

Engenharia

O que está por baixo do capô.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. HTTP primeiro, navegador só se for necessário

    Lançar o Chromium para cada página custa tempo e memória. A página é, por isso, lida primeiro por um pedido HTTP e analisada; o navegador só intervém se o resultado for pobre, se a página for uma casca de aplicação vazia ou se o site tiver servido uma página de bloqueio. O campo meta.source indica o caminho seguido.

  2. Uma proteção SSRF em cada ligação

    Uma API que visita endereços fornecidos por quem a chama pode servir para alcançar uma rede interna. Os endereços privados, de loopback e de metadados de cloud são recusados, e a resolução DNS fica fixada à ligação. No navegador, todo o tráfego sai por um proxy interno que revalida cada ligação, redirecionamentos incluídos.

  3. Nenhum código fornecido por quem chama é executado

    A API não executa nenhum script enviado pelo cliente. O que antecede uma captura descreve-se por parâmetros e seletores CSS: clicar, deslocar a página, esperar por um elemento. É uma função a menos, e é intencional: código arbitrário no navegador contrariaria o isolamento e a proteção SSRF.

  4. Nem cookie nem credencial transmitidos à página lida

    Quem chama só pode definir três cabeçalhos: Accept-Language, User-Agent e Referer. Cookie e Authorization estão excluídos, porque as respostas são guardadas em cache por endereço e servidas a todos: uma página obtida com a sessão de um utilizador seria servida ao seguinte.

  5. Cache, desduplicação e disjuntor por anfitrião

    Os resultados são guardados em cache, em memória ou no Redis, e pedidos idênticos recebidos ao mesmo tempo desencadeiam um único processamento. Um disjuntor deixa de contactar um anfitrião após várias falhas de rede consecutivas. Uma página lenta ou muito pedida não monopoliza, assim, os navegadores disponíveis.

  6. Uma referência OpenAPI extraída do código de validação

    Os parâmetros do documento OpenAPI 3.1 derivam dos esquemas de validação das rotas: a referência publicada descreve o que o servidor aceita realmente. Cada falha tem um código estável, de EINVALIDURL a ETIMEOUT, com o estado HTTP correspondente, para que o código cliente a trate sem analisar uma mensagem.

  7. Um ponto de acesso MCP para os agentes de IA

    Oito ferramentas só de leitura estão expostas em POST /mcp. Passam pelos mesmos serviços que as rotas REST e, portanto, pelos mesmos controlos. Qualquer resultado que contenha conteúdo de página começa por um aviso: este texto vem da web, é um dado a avaliar e não uma instrução a seguir.

  8. Uma única função serve a API e o site

    Na Vercel, o site é compilado e depois integrado no bundle da API: uma única função responde a tudo. O orçamento de tempo de um pedido é de 55 segundos por omissão, logo abaixo da duração máxima da função (60 segundos), para que a API responda ela própria com um erro legível em vez de ser interrompida pela plataforma.

SEO

Como o site se torna encontrável.

  1. Dezasseis páginas, cada uma em francês e em inglês

    O mapa do site declara 32 endereços: página inicial, área de testes, referência da API, dez guias, estado do serviço, acessibilidade e aviso legal, em duas línguas ligadas por etiquetas hreflang. Um programador procura uma resposta precisa; cada assunto tem, por isso, a sua própria página em vez de uma secção de uma página única.

  2. Ficheiros llms.txt para os assistentes

    O site publica /llms.txt, que lista a documentação com uma linha de resumo por página, e /llms-full.txt, que dá o seu texto integral. Um assistente de código questionado sobre a API pode assim ler a documentação atualizada em vez de adivinhar parâmetros.

  3. Dados estruturados, e API mantida fora do rastreamento

    A página inicial declara em JSON-LD o editor, a API (tipo WebAPI), o software e as suas perguntas frequentes. O ficheiro robots.txt afasta /api/ do rastreamento: as respostas da API são dados sobre outros sites, não páginas a indexar sob o nome Omnillink.

  4. Nem cookies nem medição de audiência

    O site não coloca nenhum cookie e não carrega nenhuma ferramenta de medição de audiência; as preferências de tema, de língua e de acessibilidade ficam no navegador. Não há, portanto, nenhuma faixa de consentimento a ultrapassar antes de ler a documentação.

Acessibilidade

Utilizável por todos.

Desde junho de 2025, o Ato Europeu da Acessibilidade exige a acessibilidade digital a uma grande parte dos serviços online. Tratamo-la na conceção, não como correção posterior.

  1. Um painel de opções em cada página

    Um botão abre as definições de visualização: tamanho do texto, contraste reforçado, tipo de letra Atkinson Hyperlegible, entrelinha, ligações sublinhadas, animações reduzidas. As escolhas ficam guardadas no navegador e valem para todas as páginas, sem depender das definições do sistema.

  2. O que foi verificado, e o que não foi

    A página Acessibilidade lista as verificações de 18 de novembro de 2026: contrastes calculados para os dois temas, percurso com o teclado num navegador automatizado, ausência de deslocamento horizontal a 375 píxeis. Escreve também o que falta: nenhum ensaio com um leitor de ecrã, nenhuma auditoria WCAG ou RGAA por uma pessoa formada. Dizê-lo evita dar a entender uma conformidade que não foi estabelecida.

Estrutura

O que foi entregue.

  • Página inicial — demonstração em direto, capacidades, funcionamento, auto-alojamento, perguntas frequentes
  • Área de testes — todos os parâmetros, código gerado em oito linguagens
  • Referência da API — rotas, parâmetros, erros, quotas e cache
  • Guias — primeiros passos, auto-alojamento, SDK, agentes de IA, receitas, segurança, limites
  • Estado do serviço
  • Acessibilidade, aviso legal e privacidade
Método

As etapas do projeto.

  1. API de base

    Metadados, captura de ecrã, PDF, extração e conteúdo legível; validação dos endereços, cache e implementação numa única função na Vercel.

  2. Reforço da segurança

    Proxy interno que valida cada ligação do navegador, redirecionamentos incluídos; parâmetros desconhecidos ignorados em vez de recusados.

  3. Ferramentas para programadores

    SDK TypeScript, linha de comandos, servidor MCP, componente React, ação GitHub e exemplos de integração.

  4. Site e publicação

    Área de testes, guias, pesquisa, versão inglesa, ponto de acesso MCP alojado e registo de alterações; colocação online em novembro de 2026.

Perguntas

O que nos perguntam com frequência.

O software é distribuído sob licença MIT: pode ser utilizado, modificado e alojado por conta própria, sem custo por pedido além do próprio alojamento. A instância que serve o site é uma demonstração, com um limite de pedidos.

Não. A API responde sem autenticação. O cabeçalho facultativo x-api-key eleva o limite de pedidos, e as chaves são definidas por quem explora cada instância. Por omissão, o limite é de 60 pedidos por janela sem chave e de 600 com chave.

As páginas públicas em http ou https. Os endereços privados, locais ou internos são recusados pela proteção SSRF. As páginas construídas em JavaScript são renderizadas no Chromium quando é necessário. Se um site responder com uma página de bloqueio, a API assinala-o com um erro em vez de devolver essa página como conteúdo.

Node.js 22 ou mais recente, e o Chromium, instalado pelo Playwright. O Redis é facultativo: sem ele, a cache e os contadores de quota vivem em memória, instância a instância. A exploração fica a cargo de quem aloja: atualizações, Chromium, supervisão.

O mesmo nível de exigência, para o seu site.

Auditoria gratuita do seu site atual, orçamento em 24 h e um raciocínio por escrito — como o que acabou de ler. Pagamento em três prestações sem juros; apoios locais verificados antes da assinatura.

Partilhar