Документация виджетов встраивания

Что такое встраиваемые виджеты?

Встройте любой из 557+ инструментов Akousa на свой сайт одним тегом iframe. Виджеты полностью адаптивны, настраиваемы и поддерживают все 20 языков.

Посетите галерею встраивания для просмотра инструментов, предпросмотра и копирования кода. Настраивайте тему (светлая/тёмная), язык и размеры под ваш сайт.

Как встроить инструмент

1. 1Посетите галерею встраивания или страницу документации любого инструмента
2. 2Скопируйте код iframe для встраивания
3. 3Вставьте его в HTML вашего сайта

Пример кода для встраивания

'<'iframe src="https://akousa.net/embed/json-formatter?theme=dark&lang=en" width="100%" height="500" frameborder="0">'<'/iframe>

Возможности

• ✓Посетите /embed-gallery для просмотра встраиваемых инструментов.
• ✓Скопируйте код iframe. Настройте параметрами lang и theme.
• ✓Вставьте iframe в свой HTML.

Параметры настройки

• Тема (светлая/тёмная/системная)
• Язык (20 вариантов)
• Размеры (ширина и высота через HTML-атрибуты)

Content Security Policy & Security

All embed widgets use strict Content Security Policy headers with frame-ancestors configured for cross-origin embedding. Data processing happens entirely in the visitor's browser — no user data is transmitted to Akousa servers. The embed is served over HTTPS with the same security standards as the main platform. Your visitors' data stays on their device.

Anonymous Analytics

Встроенные виджеты отслеживают анонимные счетчики просмотров внутренне, чтобы помочь вам понять модели использования. От ваших посетителей не собирается никакая личная идентифицирующая информация. Аналитика легковесна и не влияет на производительность или время загрузки виджета.

Оптимизация производительности

Страницы встраивания предварительно рендерятся для быстрой первоначальной загрузки и периодически перепроверяются. Iframe загружается асинхронно и не блокирует рендеринг вашей страницы. В сочетании с ленивой загрузкой (loading="lazy") встроенные виджеты практически не влияют на показатели Core Web Vitals вашего сайта.

Speakable Structured Data

Each embed page includes Speakable schema markup, making widget content eligible for voice assistant read-aloud. This improves accessibility for visually impaired users and positions your embedded tools for voice search discovery.

Часто задаваемые вопросы

Какие инструменты можно встраивать?

Все 557+ инструментов через формат URL /embed/[slug].

Встраивание бесплатно?

Да, полностью бесплатно без ограничений использования.

Могу ли я настроить внешний вид?

Да, с URL-параметрами ?lang=tr и ?theme=dark.

Безопасен ли встроенный контент?

Yes. Embedded widgets use a strict Content Security Policy (CSP) with frame-ancestors configured to allow cross-origin embedding. All data processing happens in the visitor's browser — no user data is transmitted to our servers.

Встроенные инструменты замедлят мой сайт?

Embedded tools load asynchronously within the iframe and do not block your page rendering or affect your site's performance. The iframe loads independently, so even if the widget takes a moment to initialize, your page content appears instantly. The widget code is optimized and cached for fast loading via static generation with periodic revalidation.

Можно ли встроить инструменты на WordPress?

Да. Используйте блок «Пользовательский HTML» в редакторе блоков WordPress и вставьте код iframe. Если ваш сайт использует плагин безопасности, удаляющий iframe, добавьте akousa.net в белый список. Встраивание работает на WordPress.com (тарифы Business) и всех самостоятельных установках WordPress.org.

Отслеживают ли встроенные виджеты аналитику?

Встроенные виджеты регистрируют только анонимные счетчики просмотров для внутренней аналитики. На ваших посетителей не устанавливаются файлы cookie, не собираются личные данные, и в iframe не загружаются сторонние трекеры. Собственная аналитика вашего сайта (Google Analytics, Plausible и т.д.) не затрагивается встраиванием.

Нужно ли настраивать CSP-заголовки для встраивания?

Если ваш сайт использует Content Security Policy, добавьте 'frame-src https://akousa.net' в CSP-заголовок. Большинство сайтов без явной CSP работают сразу. Сам эндпоинт встраивания устанавливает разрешающие заголовки frame-ancestors.

Как встраивание влияет на производительность страницы?

Каждый встроенный виджет загружается в изолированном контексте iframe, не блокируя основной поток, DOM или критический путь отрисовки вашей страницы. Добавьте loading="lazy" к тегу iframe для отложенной загрузки, дополнительно улучшив Core Web Vitals.

Можно ли использовать встроенные инструменты в коммерческих проектах?

Да, вы можете встраивать любой инструмент на коммерческие сайты, SaaS-панели, клиентские проекты и внутренние инструменты. Нет лицензионного сбора, лимитов использования и требований к атрибуции, кроме небольшой ссылки «Powered by akousa.net», автоматически включённой в каждый виджет.

Связанная документация

• Документация по инструментам

  Полное руководство по использованию 557+ бесплатных онлайн-инструментов. Узнайте об инструментах для разработчиков, текстовых процессорах, конвертерах и генераторах — всё работает в вашем браузере без регистрации.

• Справочник API для разработчиков

  Полная документация по REST API akousa.net с 64 конечными точками в 13 группах.

• Embed Gallery

  The Embed Gallery at /embed-gallery is a dedicated landing page for webmasters. Browse all 557+ embeddable tools, preview how each looks as a widget, check recommended dimensions, and copy the ready-to-use iframe code with one click.

• Документация PDF Suite

  Руководство по 13 PDF-инструментам: объединение, разделение, сжатие, конвертация и другое.