API WisyLink позволяет создавать и обновлять размещённые сайты из кода. Загрузите справочные файлы, отправьте сообщение обычным языком в POST /chat — и агент соберёт сайт и разместит его по собственному адресу на wisylink.com. Чтобы изменить сайт, отправьте новое сообщение с тем же id ссылки. Запросы к API расходуют тот же 5-часовой и недельный лимит вашего тарифа.
- Несколько REST-эндпоинтов покрывают весь жизненный цикл: загрузка файлов, создание или продолжение сайта через
POST /chat, проверка статуса, список и удаление сайтов. POST /chatобщается с Wisy — тем же ассистентом, что и в приложении, поэтому в ответ может прийти вопрос, а не сборка. Проверьтеstatus, прежде чем начинать опрос.- API-ключи создаются на сайте, и у каждого есть собственный лимит расходов — до $10 в день, неделю или месяц — поверх лимитов вашего тарифа.
- npm-пакет
@wisylink/cliоборачивает те же эндпоинты в утилиту командной строки и Node-клиент. - Свой домен и ключи сервисов (Stripe, почта) настраиваются в веб- или мобильном приложении; публичный API их не охватывает.
Что можно автоматизировать
API — это тот же чат, только без окна чата. Каждый вызов POST /chat — это сообщение для Wisy; когда задача понятна, ИИ-агент сборки пишет веб-приложение с серверным рендерингом и публикует его по адресу https://<id>.wisylink.com, добавляя сохранение данных, аккаунты или загрузку файлов, если этого требует описание. Параметров для шаблона, темы или типа страницы нет. Всё о сайте — от разделов и текстов до функций и стиля — передаётся в сообщении, так же как это описал бы человек. (Общие принципы мы разбирали в статье о том, что такое ИИ-конструктор приложений.)
Базовый URL — https://api.wisylink.com. Аутентификация — через заголовок x-api-key: <key> или Authorization: Bearer <key>. JSON-эндпоинты принимают Content-Type: application/json, а время указывается в миллисекундах Unix-эпохи.
| Эндпоинт | Метод | Назначение | Ключевые поля |
|---|---|---|---|
/files | POST | Начать загрузку файла | на входе name, на выходе id |
/files/chunks | POST | Загрузить байты файла, не больше 4 МБ за запрос | id и last=true в последней части; тело — сырые двоичные данные |
/files/:id | GET | Получить метаданные файла | content_type, name, size |
/files/:id | DELETE | Удалить файл | Он также убирается из file_ids всех ссылок |
/chat | POST | Создать сайт (без id) или продолжить работу над ним (с id) | message, до 10 file_ids; возвращает id, url, status, answer |
/links | GET | Список ваших сайтов, сначала новые | page, limit (от 1 до 100); items, total_pages, has_next |
/links/:id | GET | Получить данные одного сайта | status, url, file_ids |
/links/:id | DELETE | Удалить сайт и его справочные файлы | Возвращает {"ok": true} |
Чего публичный API не делает: не задаёт ключи, нужные сайту для платежей или почты (владелец вставляет их в разделе «Интеграции»), не подключает свой домен, не читает и не записывает сохранённые данные сайта и не экспортирует исходный код.
Как получить API-ключ и задать лимит расходов
- Войдите на wisylink.com. Ключи создаются только на сайте, в мобильных приложениях этого нет.
- Откройте раздел «API-ключи» в настройках аккаунта и нажмите «Сгенерировать ключ».
- Назовите ключ по месту, где он будет работать, например «acme-landing-pages-ci», чтобы знать, что сломается, если вы его отзовёте.
- Задайте окно и лимит. Выберите день, неделю или месяц и лимит расходов в долларах — до $10 на окно. Окна считаются по суткам UTC, по неделе с понедельника или по календарному месяцу.
- Сразу скопируйте ключ. Он показывается один раз. Сохраните его в менеджере секретов или в секретах CI, например как
WISYLINK_API_KEY.
Лимит ключа — это предохранитель, а не ваш тариф. Каждый запрос ещё и расходует скользящие 5-часовое и недельное окна вашего аккаунта — те же, что у чата на сайте и в мобильном приложении. Расход считается по объёму ИИ-работы, которую запускает запрос, включая чтение ваших справочных файлов. Лимит проверяется перед каждым запросом, а расход записывается после него, поэтому последний запрос в окне может немного превысить лимит. Отзыв ключа сразу удаляет его, и всё, что им ещё пользуется, получает 401.
Можно ли пользоваться API на бесплатном тарифе? Да. На Community действуют те же правила, что и в приложении: одна сборка за 5-часовое окно, а сайты работают 30 дней и ещё неделю остаются помеченными на удаление. Этого достаточно, чтобы сделать прототип интеграции; для клиентских проектов и пакетной работы платный тариф даёт больший лимит, параллельные сборки и ссылки, которые работают, пока действует подписка.
Загрузка справочных файлов по частям
Справочные файлы — это всё, что агент должен прочитать или разместить на сайте: брендбук, логотип, фото товаров, прайс-лист. Поддерживаются JPEG, PNG, WebP, GIF, HEIC, SVG, MP3, MP4, PDF, XLSX, DOCX, CSV, TXT, JSON и HTML, до 25 МБ каждый. Настоящий тип определяется по содержимому файла, а пустые файлы отклоняются.
Загрузка занимает два вызова. Сначала создайте файл и сохраните полученный id:
curl -s -X POST https://api.wisylink.com/files -H "x-api-key: $WISYLINK_API_KEY" -H "Content-Type: application/json" -d '{"name":"brand-guide.pdf"}'
Затем отправьте содержимое. Файл размером до 4 МБ уходит одним запросом с last=true:
curl -s -X POST "https://api.wisylink.com/files/chunks?id=$FILE_ID&last=true" -H "x-api-key: $WISYLINK_API_KEY" -H "Content-Type: application/octet-stream" --data-binary @brand-guide.pdf
Файлы побольше разрежьте (split -b 4m brand-guide.pdf part_), отправьте части по порядку на тот же id и добавьте last=true только к последней: этот вызов завершает загрузку и запускает обработку файла. Загрузка должна завершиться за 15 минут, иначе сессия истекает. В Node разбиение на части берёт на себя клиент, о котором речь ниже.
Создание сайта через POST /chat и ожидание адреса
Отправка описания
Чтобы начать новый сайт, не передавайте id. Сообщение может быть длиной до 5000 символов — этого хватает на полноценное техзадание: цель, аудитория, разделы, реальные тексты, функции, стиль и язык. Закончите его фразой «остальное выберите на своё усмотрение», чтобы повысить шанс, что сборка начнётся с первого вызова. Замените FILE_ID на id из вашей загрузки.
curl -s -X POST https://api.wisylink.com/chat -H "x-api-key: $WISYLINK_API_KEY" -H "Content-Type: application/json" -d '{"message":"Сделайте одностраничный сайт для «Эмбер», обжарщика спешелти-кофе в Казани. Разделы: главный экран, три моносорта с ценами, форма оптовой заявки с сохранением в админку, часы работы, ссылка на карту. Цвета и шрифты возьмите из приложенного брендбука. Остальное выберите на своё усмотрение.","file_ids":["FILE_ID"]}'
Тот же вызов из Node через fetch:
const res = await fetch("https://api.wisylink.com/chat", { method: "POST", headers: { "x-api-key": process.env.WISYLINK_API_KEY, "Content-Type": "application/json" }, body: JSON.stringify({ message: brief, file_ids: [fileId] }) }); let link = await res.json();
Для нового сайта ответ приходит с кодом 201 и полями id, url, status, answer, created_at и updated_at. Сохраните id: по нему вы позже будете менять, читать или удалять сайт. Считайте его непрозрачной строкой и не проверяйте формат.
Проверьте статус перед опросом
Поле status в ответе POST /chat показывает, началась ли сборка на самом деле:
buildingилиqueued- Сборка идёт или ждёт свободного места (
queuedпока нет в списке справочника, но он встречается). Начинайте опрос. У нового сайта по адресуurlоткрывается страница «идёт сборка», пока не завершится первая сборка. idleу нового сайта- Сборка не началась. Вместо неё Wisy ответил, и в
answerобычно один короткий вопрос, например какой платёжный сервис использовать. Ответьте новым вызовомPOST /chatс тем жеid. completedилиabortedсразу после продолжения- У существующего сайта статус показывает результат последней сборки. Если он не сменился на
building, на ваше сообщение пришёл ответ, а не сборка; прочитайтеanswer.
Опрашивайте, пока сборка не завершится
Вебхуков нет, поэтому опрашивайте GET /links/:id. Сборка длится минуты, а не секунды, так что раза в 15–30 секунд вполне достаточно. Считайте любой статус, кроме completed, aborted и idle, признаком того, что работа ещё идёт: так цикл не сломается, если появится новый промежуточный статус:
const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); while (!["completed", "aborted", "idle"].includes(link.status)) { await sleep(20000); link = await (await fetch(`https://api.wisylink.com/links/${link.id}`, { headers: { "x-api-key": process.env.WISYLINK_API_KEY } })).json(); }
Когда status равен completed, в url — ваш работающий сайт. aborted означает, что сборка остановилась, не завершившись; уже работающий сайт сохраняет предыдущую версию, а новое сообщение запускает ещё одну попытку. Если позже к сайту подключат свой домен, url будет возвращать этот домен. Полный отчёт о сборке, включая пометку, что сайт ждёт ключей Stripe или почты, есть в чате этой ссылки в веб-приложении.
Продолжение, список и удаление ссылок
Чтобы изменить сайт, отправьте только новую инструкцию и его id вместо LINK_ID; история разговора хранится на сервере, а на продолжение приходит ответ 200:
curl -s -X POST https://api.wisylink.com/chat -H "x-api-key: $WISYLINK_API_KEY" -H "Content-Type: application/json" -d '{"id":"LINK_ID","message":"Добавьте вторую точку: ул. Баумана, 12, ежедневно с 7:00 до 15:00."}'
Затем опрашивайте статус так же, как раньше. Каждое изменение — новая сборка: неудачная оставляет в работе последнюю удачную версию, а удачная публикуется сразу после завершения, поэтому проверяйте сайт после каждого изменения. Дождитесь окончания одной сборки, прежде чем отправлять следующее изменение, если только новое сообщение не исправляет текущую сборку.
Чтобы получить список сайтов, листайте GET /links?page=1&limit=100, пока has_next не станет false. Чтобы удалить сайт, вызовите DELETE /links/:id: он удаляет сайт и прикреплённые к нему справочные файлы. Свой домен, если он был подключён, остаётся в аккаунте и готов для другого сайта.
CLI и Node-клиент
Пакет @wisylink/cli (лицензия MIT, Node 18.17 или новее) сопоставляет команды с эндпоинтами выше один к одному, поэтому это самый быстрый способ управлять WisyLink из скрипта оболочки или задачи CI:
npm i -g @wisylink/cli, затемexport WISYLINK_API_KEY=...или флаг--api-keyв каждой команде.wisylink files upload ./brand-guide.pdfзагружает файл частями по 4 МБ автоматически.wisylink chat --message "Сделайте лендинг для кофейни «Эмбер»." --file-id FILE_IDсоздаёт сайт.wisylink links list --page 1 --limit 50выводит список ваших сайтов.
Команды печатают JSON, поэтому id или url легко достать через jq. --timeout принимает от 1000 до 120 000 миллисекунд; увеличьте его для chat, которая ждёт ответа Wisy.
Тот же пакет экспортирует Node-клиент: import { CreateWisyLinkClient } from "@wisylink/cli"; const client = CreateWisyLinkClient({ apiKey: process.env.WISYLINK_API_KEY }); const file = await client.uploadFile("./brand-guide.pdf"); const link = await client.chat({ message: brief, fileIds: [file.id] });
Два замечания о версиях на момент npm-релиза 0.2.1. Во-первых, команды и методы клиента, принимающие id ссылки (chat --link-id, links get, links delete, а в Node — linkId, getLink, deleteLink), проверяют id по старому формату и отклоняют текущие, поэтому продолжайте, читайте и удаляйте сайты через HTTP, как показано выше. Во-вторых, документация CLI (на английском) уже описывает более новый релиз со входом через браузер (wisylink login), интерактивным чатом с ходом сборки в реальном времени и флагом --json; выполните wisylink --version, чтобы узнать, какая версия у вас.
Лимиты, ошибки и хорошие практики
Ошибки возвращаются в виде JSON с кодом в поле error. Вот те, которые стоит обрабатывать отдельно:
429 limit_reached- 5-часовое или недельное окно вашего тарифа исчерпано (
reasonравен5h_limitилиweekly_limit). Запланируйте повтор на моментreset_at(в миллисекундах эпохи), а не повторяйте запрос в цикле. 429 credit_limit_exceeded- Этот ключ исчерпал собственный лимит расходов. Ошибка возможна на любом эндпоинте; дождитесь
resets_atили поднимите лимит (до $10) на сайте. 429 build_concurrency_limit- Для вашего тарифа запущено слишком много сборок. Дождитесь завершения одной из них и отправьте следующую.
429 rate_limited- Слишком много запросов за короткое время. Сделайте паузу и повторите.
400 bad_request- Некорректный JSON, пустое сообщение или сообщение длиннее 5000 символов либо несуществующие id файлов (они перечислены в
missing_file_ids). Учтите, что используются только первые 10file_ids; лишние отбрасываются без ошибки. 401,404,500 chat_unavailable- Ключ отсутствует или отозван; ссылка или файл вам не принадлежат; Wisy временно недоступен — стоит один раз повторить запрос после паузы.
Привычки, которые экономят деньги и нервы:
- Храните ключи на сервере. Никогда не вставляйте ключ в код браузера или приложения. Заведите по ключу на каждого клиента или конвейер, чтобы у каждого был свой лимит и его можно было отозвать отдельно.
- Не повторяйте
POST /chatвслепую. Этот вызов не идемпотентен: запрос, который на вашей стороне завершился по таймауту, мог всё же создать сайт или запустить сборку. Прежде чем отправлять его снова, проверьтеGET /links(новые идут первыми) и задайте клиентский таймаут не меньше минуты. - Ставьте пакетные задачи в очередь. Запускайте одновременно столько сборок, сколько позволяет тариф, а
build_concurrency_limitвоспринимайте как сигнал подождать. - Проверяйте перед публикацией. Результат работы ИИ может содержать ошибки. Откройте каждый сайт, проверьте формы и прочитайте тексты, прежде чем их увидит клиент или публика; по условиям WisyLink проверка и тестирование — ваша ответственность.
Примеры: лендинги, микросайты, внутренние инструменты
Лендинги для клиентов агентства. Держите шаблон описания с полями для названия клиента, оффера, разделов и тона, заполняйте его из CRM и прикрепляйте логотип и брендбук клиента как файлы. Каждая кампания становится отдельным сайтом, правки клиента — следующими сообщениями, а отдельный ключ на клиента разделяет расходы. Когда страницу одобрят, подключите домен клиента в разделе «Домены» на любом тарифе; платный тариф сохранит сайт в сети после первых 30 бесплатных дней. Разобранный пример самой страницы — в статье о том, как сделать лендинг с листом ожидания с помощью ИИ.
Микросайты для каждого мероприятия. Одна строка в таблице на мероприятие (название, дата, площадка, вместимость) превращается в отдельный сайт регистрации, который создаёт скрипт, сохраняя полученный id рядом со строкой. Что писать в каждом описании, показывает статья о том, как создать страницу регистрации на мероприятие с ИИ. После мероприятия удалите сайт или оставьте его как архив на платном тарифе.
Внутренняя автоматизация. Скрипт может создать первую версию внутреннего инструмента, например учёта остатков или доски согласований. Но не пересобирайте сайт ради обновления данных: попросите Wisy добавить эндпоинт, в который ваши системы будут отправлять записи, и защитить его секретом, который вы зададите в разделе «Интеграции». Записи, отправленные таким способом, видны посетителям примерно через минуту и не расходуют сборку. Подробнее об этом подходе — в статье о внутренних инструментах с ИИ.
Получите ключ и соберите первый сайт из кода
Создайте бесплатный аккаунт, сгенерируйте API-ключ с небольшим лимитом и отправьте первое описание вызовом curl, показанным выше. Держите под рукой справочник API (на английском) с подробностями по каждому полю, а когда интеграция перерастёт прототип, выберите в разделе с тарифами план с тем лимитом сборок и числом параллельных сборок, которые нужны для ваших объёмов.
ЧАВО