Для интеграции нашего сервиса вручную достаточно добавить динамическую ссылку на сгенерированное изображение в HTML-код вашего сайта. Мы поддерживаем два формата URL для генерации изображений:
1. Без указания заголовка:
https:/generate/{url}/og.png
Здесь {url}
— это закодированный (URL-encoded) адрес страницы, для которой создается изображение. Система автоматически извлечет заголовок страницы из тегов в порядке приоритета:
<meta property="ogimage:title">
<meta property="og:title">
<title>
2. С указанием заголовка:
https:/generate/{url}/{title}/og.png
Здесь {url}
— адрес страницы, а {title}
— заголовок страницы, также закодированный в формате URL-encoded. Этот формат позволяет вручную задать заголовок для изображения.
Для добавления динамического фонового изображения в HTML необходимо использовать следующий тег:
<meta property="ogimage:image">
Пример добавления в HTML
<head>
<!-- без указания заголовка -->
<meta property="ogimage:title" content="My Custom Title">
<!-- или -->
<meta property="og:title" content="My Custom Title">
<!-- или -->
<title>My Custom Title</title>
<meta property="ogimage:image" content="https://mysite.com/article/thumbnail.png">
<meta property="og:image" content="https://api.ogimage.ru/generate/https%3A%2F%2Fmysite.com%2Farticle/og.png">
<!-- // без указания заголовка -->
<!-- или с указанием заголовка -->
<meta property="og:image" content="https://api.ogimage.ru/generate/https%3A%2F%2Fmysite.com%2Farticle/My%2520Custom%2520Title/og.png">
</head>
ВАЖНО: при использовании схемы с передачей заголовка в ссылке, фоновое изображения считываться не будет.