Гайд

Встраивание инструментов для вебмастеров

Лёгкие страницы под /embed/ позволяют встроить те же браузерные утилиты на ваш сайт. Полная страница инструмента — для локализации, FAQ и приватности.

Обновлено: 2026-05-03
Embed-страницы — статический HTML с salamyx.com. Ваш сайт загружает наш origin в iframe; применяйте свои правила для сторонних контекстов, куки и аналитики.

Зачем это нужно

Официальные цели для iframe под https://salamyx.com/embed/... загружают те же браузерные инструменты с минимальной оболочкой. Основной сайт остаётся с SAMEORIGIN; стороннее встраивание рассчитано только на /embed/.

Разрешённые URL для встраивания

В продакшене используйте только эти значения src. Полная страница инструмента остаётся каноническим документом для SEO и ассистентов.

Полная страница инструмента и соответствующий iframe src
Полная страница (canonical)	iframe src (embed)	Гайд по инструменту
UUID / GUID Generator	`https://salamyx.com/embed/developers/uuid/`	Открыть
JSON Formatter And Validator	`https://salamyx.com/embed/developers/json-formatter/`	Открыть
Word Counter	`https://salamyx.com/embed/text/word-counter/`	Открыть

Минимальная разметка iframe

Задайте небольшую начальную высоту (например 96–120px) и увеличивайте iframe по событиям postMessage с высотой. У iframe должен быть понятный title для скринридеров.

<iframe
  id="salamyx-embed-frame"
  src="https://salamyx.com/embed/developers/uuid/"
  title="UUID / GUID Generator (salamyx.com embed)"
  style="width:100%;min-height:120px;height:120px;border:0;border-radius:12px;background:#0b1223;"
  loading="lazy"
  referrerpolicy="strict-origin-when-cross-origin"
></iframe>

Автовысота через postMessage

Документы embed отправляют подсказки родителю. В продакшене проверяйте и event.origin === "https://salamyx.com" , и форму сообщения, прежде чем менять вёрстку.

const ALLOWED_ORIGIN = 'https://salamyx.com';

window.addEventListener('message', (event) => {
  if (event.origin !== ALLOWED_ORIGIN) return;
  const data = event.data;
  if (!data || data.source !== 'salamyx-embed' || data.type !== 'resize') return;
  const iframe = document.getElementById('salamyx-embed-frame');
  if (!(iframe instanceof HTMLIFrameElement)) return;
  iframe.style.height = `${Math.max(320, Number(data.height) || 0)}px`;
});

Заметка про хостинг (Apache)

В production-файле .htaccess этого репозитория для путей /embed/ задаётся CSP frame-ancestors *, а ограничение X-Frame-Options снимается. На других CDN/серверах воспроизведите ту же политику.

Индексация, canonical и безопасность (для SEO и LLM)

Индексация: HTML embed с noindex,follow. Ранжировать нужно полный URL инструмента, а не документ внутри iframe.
Canonical: У каждой страницы /embed/ link rel=canonical ведёт на полную страницу инструмента.
Контракт postMessage: Проверяйте data.source === "salamyx-embed" и data.type === "resize", высота в data.height (px). Желательно сверять event.origin с https://salamyx.com.
Политика framing: Не встраивайте обычные URL инструментов: для сторонних сайтов framing не гарантирован. Только пути /embed/.

Для каталога и метаданных в автоматизации используйте Tools API v1.

Приватность и ограничения

Embed-страницы — статический HTML с salamyx.com. Ваш сайт загружает наш origin в iframe; применяйте свои правила для сторонних контекстов, куки и аналитики.

Только ограниченный список инструментов имеет embed-маршрут; URL вне /embed/ не гарантируют разрешение framing.
Высота iframe сама не подстраивается, пока вы не обработаете postMessage из встраиваемой страницы.
Интерфейс embed в первой версии на английском; полные страницы поддерживают несколько языков.

Связанные страницы

FAQ

Какой URL указывать в src у iframe?

Используйте задокументированные https://salamyx.com/embed/... Не встраивайте обычный URL инструмента: для сторонних сайтов он намеренно не разрешён для framing.

Как автоматически менять высоту iframe?

Слушайте события message на window: data.source === "salamyx-embed" и data.type === "resize", затем выставляйте высоту iframe из data.height.

Появятся ли другие инструменты?

Да, по мере UX- и security-ревью каждого инструмента. Актуальный список — в этой документации и в исходниках сайта (модуль embed-tools).

Меняется ли место обработки ввода?

Нет. Обработка по-прежнему в браузере посетителя внутри iframe. Маршрут /embed/ меняет только оболочку и заголовки framing.

Можно ли убрать атрибуцию?

Оставляйте iframe на salamyx.com, чтобы пользователь видел реальный origin. Не выдавайте инструмент за собственную разработку.