Recettes
Quatre usages courants, avec le code minimal pour chacun.
Aperçus de liens dans un blog
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.
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.
<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.
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.
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.