{
"ok": true,
"data": {
"url": "https://github.com",
"final_url": "https://github.com",
"status_code": 200,
"title": "GitHub · Change is constant. GitHub keeps you ahead. · GitHub",
"description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
"image": "https://images.ctfassets.net/8aevphvgewt8/76epZKB2wF998m4e4bLLXn/c505f20b00ec70b88b1be5aec42c4be4/OG_image.jpg",
"site_name": "GitHub",
"favicon": "https://github.com/fluidicon.png",
"canonical": "https://github.com",
"type": "object",
"twitter_card": "summary_large_image",
"language": "en"
},
"meta": {
"request_id": "74494e4e82aa4879aa49a381209f3935",
"api": "link-preview",
"version": "1",
"elapsed_ms": 2177,
"llm_used": false,
"cache_hit": false,
"warnings": [],
"plan": null
}
}
curl --location --request GET 'https://zylalabs.com/api/15181/link+preview+unfurl+api/40591/preview+get?url=https://github.com' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"data": {
"url": "https://github.com",
"final_url": "https://github.com",
"status_code": 200,
"title": "GitHub · Change is constant. GitHub keeps you ahead. · GitHub",
"description": "Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.",
"image": "https://images.ctfassets.net/8aevphvgewt8/76epZKB2wF998m4e4bLLXn/c505f20b00ec70b88b1be5aec42c4be4/OG_image.jpg",
"site_name": "GitHub",
"favicon": "https://github.com/fluidicon.png",
"canonical": "https://github.com",
"type": "object",
"twitter_card": "summary_large_image",
"language": "en"
},
"meta": {
"request_id": "42b5e2c3a7ee46d9ad148a81bd46bc06",
"api": "link-preview",
"version": "1",
"elapsed_ms": 2616,
"llm_used": false,
"cache_hit": false,
"warnings": [],
"plan": null
}
}
curl --location --request POST 'https://zylalabs.com/api/15181/link+preview+unfurl+api/40592/preview+post' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"url":"https://github.com"}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Desplegar vista previa del enlace API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Despliega una URL en metadatos de Open Graph y Twitter Card, además de un favicon. La captura de pantalla no está disponible actualmente; las vistas previas de metadatos son totalmente compatibles
Devuelve el título, la descripción, la imagen, el nombre del sitio, el favicon, la URL canónica y el tipo de tarjeta que una aplicación de chat o un CMS muestra debajo de un enlace
Lee primero las etiquetas Open Graph y Twitter Card y, si no las encuentra, recurre al título HTML y a la metadescripción
La captura de pantalla no está disponible actualmente; las vistas previas de metadatos son totalmente compatibles. .
Los hosts privados, las direcciones de metadatos y los puertos que no son web se rechazan antes de que se obtenga la página. .
Envía GET /v1/preview?url=https://github.com/ con tu encabezado X-Api-Key. La respuesta JSON contiene los metadatos de la página y el favicon.
Está diseñado para aplicaciones de chat, editores de CMS y cualquier producto que necesite mostrar una tarjeta enriquecida debajo de un enlace pegado. .
Ambos endpoints devuelven metadatos del enlace. El endpoint GET recibe la URL de destino como parámetro de consulta, mientras que el endpoint POST recibe la URL en el cuerpo de la solicitud JSON. Sus datos de vista previa usan la misma estructura general de respuesta.
El objeto de datos puede incluir la URL solicitada la URL final el código de estado HTTP el título la descripción la imagen el nombre del sitio el favicon la URL canónica el tipo de contenido el valor de Twitter Card y el idioma
Final_url es la URL a la que se llega después de redirecciones u otros cambios de navegación. Compárala con url para identificar si la dirección original redirigió a otra página.
Canonical contiene la URL preferida declarada de la página cuando está disponible language identifica el idioma detectado o declarado de la página como «en» ayudando a las aplicaciones a etiquetar o procesar las vistas previas de forma adecuada
Comprueba primero el campo ok de nivel superior Cuando la operación tenga éxito usa data para la vista previa y status_code para el resultado HTTP de la página obtenida Inspecciona también los campos para detectar valores faltantes porque es posible que algunas páginas no proporcionen todos los elementos de metadatos
El objeto meta contiene diagnósticos de la solicitud, como request_id, el nombre de la API, la versión, elapsed_ms y otros metadatos de procesamiento. Usa request_id para relacionar una respuesta con los registros o las investigaciones de soporte
La respuesta puede contener valores vacíos o ausentes en campos como image, site_name, favicon, canonical o twitter_card. Las aplicaciones deben tratar estos campos como opcionales y recurrir a presentaciones más sencillas utilizando el título, la descripción y la URL disponibles
Usa la imagen como ilustración principal de la vista previa enriquecida y el favicon como icono del sitio. Ambos se devuelven como URL para que los clientes puedan mostrarlos en tarjetas o listas y gestionar con elegancia los recursos ausentes, inaccesibles o inadecuados