Sur cette page

Recettes

Quatre usages courants, avec le code minimal pour chacun.

Appelez /meta au moment de la publication, ou côté serveur, et gardez le résultat avec l’article. Vous n’appelez pas l’API à chaque visite.

JavaScript
async function linkCard(url) {
  const params = new URLSearchParams({ url });
  const response = await fetch(`https://omnillink.kayzen-lyon.com/api/v1/meta?${params}`);
  const { status, data } = await response.json();
  if (status !== "success") return null;
  return {
    title: data.title ?? new URL(data.url).hostname,
    description: data.description,
    image: data.image?.url ?? null,
    site: data.publisher,
  };
}

Images de partage

Capturez une page conçue pour cela, à la taille attendue par les réseaux sociaux. selector limite la capture à un élément.

HTML
<meta property="og:image"
  content="https://omnillink.kayzen-lyon.com/api/v1/screenshot?url=https%3A%2F%2Fexample.com%2Fcards%2Flaunch&width=1200&height=630&format=jpeg" />

Veille de prix

Décrivez les champs une fois ; rappelez la même requête à intervalles réguliers. ttl fixe la durée pendant laquelle la réponse reste en cache.

Terminal
curl -G "https://omnillink.kayzen-lyon.com/api/v1/extract" \
  --data-urlencode "url=https://example.com/product/42" \
  --data-urlencode 'fields={"name":{"selector":"h1"},"price":{"selector":".price","type":"number"}}' \
  --data-urlencode "ttl=900"

Archivage en PDF

/pdf rend la page avec sa feuille de style d’impression. force=true garantit une copie de la page telle qu’elle est à cet instant.

Terminal
curl -o archive.pdf "https://omnillink.kayzen-lyon.com/api/v1/pdf?url=https%3A%2F%2Fexample.com%2Fblog%2Flaunch&format=A4&force=true"

Vérifiez que vous avez le droit de copier et de conserver les pages que vous archivez ou collectez.

Raccourcis clavier

CtrlKou/
Ouvrir la recherche et les commandes
?
Afficher cette aide
←→
Passer d’un onglet à l’autre
Ctrl↵
Lancer la requête dans le bac à sable
Esc
Fermer un panneau ou un menu

Les raccourcis à une seule touche se désactivent dans les options d’accessibilité.