Для розробників
Zinn Digital® — це платформа на основі підходу API-first. Той самий рушійний API, який забезпечує роботу нашої панелі керування, отримуєте й ви — з підтримкою версійності, орієнтований на специфікацію та на 100% задокументований під час збирання, зі створеними SDK, CLI, провайдером Terraform, підписаними вебхуками та сервером MCP на додачу. Хоч би чим ви користувалися для роботи — терміналом, конвеєром, файлом стану чи ШІ-агентом, — платформа реагує на це.
Більшість хостингів додають API до панелі керування вже постфактум, і це помітно — половина функцій панелі так ніколи й не виходить назовні. Ми побудували все навпаки. Панель приладів, консоль адміністратора, CLI, провайдер Terraform, сервер MCP та ваші власні інтеграції використовують один і той самий API рушія. Якщо ви можете зробити це в панелі, ви можете зробити це і в коді.
Специфікація OpenAPI є єдиним джерелом достовірних даних, і жодна кінцева точка не випускається, якщо її немає в специфікації. Саме це єдине правило забезпечує повне документування публічного API під час збирання, а не згодом — немає жодного незадокументованого куточка, оскільки незадокументована кінцева точка просто не може існувати.
Інтерактивна довідкова документація, чотири клієнтські SDK, більша частина CLI та каркас провайдера Terraform генеруються з цієї єдиної специфікації. Одне джерело, багато артефактів, завжди синхронізовані — вам ніколи не доведеться наздоганяти документацію, яка розійшлася з реалізацією.
Кінцеві точки розташовані під /v1 із опублікованою політикою припинення підтримки та журналом змін. Вас письмово попереджають перед тим, як щось зміниться, а не змушують дізнаватися про це через невдалу збірку.
Контрактні тести на відповідність реалізації специфікації та перевірка OpenAPI виконуються під час кожної зміни. Розбіжність між кодом і контрактом призводить до помилки збирання — тому специфікація, на основі якої ви створюєте свого клієнта, є специфікацією, якої сервер дійсно дотримується.
Два способи доступу, за якими стоїть єдиний принцип. Хоч би який із них ви використовували, застосовуються ті самі перевірки дозволів і та сама ізоляція на рівні бази даних.
Ключі мають вигляд zdk_<mode>_<prefix>_<secret>. Зберігається лише хеш SHA-256 секретної частини — ми не зможемо показати вам ключ знову після створення, як і будь-хто, хто отримає доступ до нашої бази даних. Ключі мають області дії, можуть бути відкликані та видаються для організації, а не для окремої особи.
Ключі пісочниці відокремлені від робочих ключів і працюють у режимі пісочниці: без реальних нарахувань, без фактичного виділення ресурсів. Ваші інтеграційні тести можуть інтенсивно навантажувати API без витрачання грошей чи розгортання серверів.
Сеанси користувачів автентифікуються за допомогою виданих Keycloak токенів JWT, перевірених за відкритим ключем realm, і розпізнаються як той самий об'єкт Principal, що й ключ API. Кінцеві точки обмежуються деталізованими ключами дозволів, такими як sites.create або apikeys.manage, які перевіряються для кожної організації окремо — дозвіл в одній організації не надає доступу до окремої, не пов'язаної організації, хоча він застосовується до організацій, вкладених у неї.
Кожен запит орендаря виконується в транзакції з областю організації Postgres, заданою з принципала, тому ізоляція забезпечується базою даних, а не фільтром ORM, про який хтось може забути. Фільтр queryset усе ще присутній як ешелонований захист.
Зробити так, щоб API мав гарний вигляд у файлі README, легко, але змусити його правильно працювати під реальним трафіком — важко. Це саме ті частини, над якими ми добряче попітніли, адже саме вони ламають інтеграції о третій годині ночі.
Одна деталь, про яку варто згадати, оскільки вона визначає особливості масової роботи: помилка 409 у разі дублювання домену відповідає на запитання «чи розміщено це ім'я хосту тут?» для будь-якого орендаря, що є оракулом перелічення та реальним ризиком деанонімізації для Footprint-Free. Обмеження швидкості створення сайтів було б невиправдано простим рішенням і повністю порушило б роботу продукту для масового надання ресурсів. Натомість ліміт встановлюється лише для відхилених спроб створення дублікатів доменів для кожного принципала. Успішні створення ніколи не зараховуються до цього ліміту — тому ви можете надавати ресурси масово протягом усього дня, а спроби зондування припиняються майже миттєво.
Три споживачі однієї специфікації для трьох різних способів роботи.
Згенеровано для TypeScript, Python, PHP та Go з відстеженням специфікації, тому нова кінцева точка з'являється у вашій мові без очікування написаної вручну обгортки.
Створіть структуру сайту WordPress, запустіть його локально, маючи встановленим лише Node, та розгорніть його. Zinnector® попередньо перевіряє ваш проєкт на відповідність слоту, у який ви збираєтеся його розгорнути — версія PHP, диск, кількість файлів — і попереджає до того, як ви відправите зміни, а не після. Він також входить у систему, показує список сайтів, розгортає, керує доменами та DNS, зчитує поштові служби, створює резервні копії, виконує дозволені команди WP-CLI, відстежує логи в реальному часі та запускає масові операції. Безкоштовно, за ліцензією MIT та створено на базі цього ж публічного API.
Керуйте сайтами, доменами, записами DNS, поштовими скриньками та планами як інфраструктурою як кодом. Команда terraform apply розгортає хостинг, і ваші середовища стають відтворюваними та придатними для перевірки замість послідовності кліків, яку ніхто не записав.
Згенерована документація, яку ви можете читати та викликати з браузера, що точно описує кінцеві точки, реалізовані сервером — оскільки обидва елементи походять з однієї специфікації.
В основі платформи лежить надійна магістраль подій: кожна зміна стану атомарно зі зміною в базі даних записує подію в транзакційний outbox у Postgres, а реле публікує її в NATS JetStream. Події є типізованими та версіованими — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending та інші.
Зареєструйте кінцеву точку як WebhookSubscription та виберіть типи подій, які вона отримує. Один потік живить сповіщення, аналітику, автоматизацію та вашу інтеграцію — ви використовуєте ті самі події, що й ми.
Кожна доставка підписана за допомогою HMAC, щоб ви могли перевірити, що вона надійшла від нас, перш ніж виконувати будь-які дії.
Невдалі доставки повторюються з поступовим збільшенням інтервалу, і кожна спроба записується як WebhookDelivery. Ви можете перевіряти та повторювати доставки з панелі керування замість того, щоб писати на електронну пошту служби підтримки із запитанням про те, що саме ми надіслали.
Конвеєр навмисно реалізовано за принципом «щонайменше один раз» (at-least-once), замість вдавати, що це «точно один раз» (exactly-once). У реле, яке аварійно вимикається під час публікації, спливає термін оренди клейму, і його події публікуються повторно. Виконуйте дедуплікацію за envelope id, і ваш споживач буде коректним за побудовою.
API — це лише половина історії розробника. Інша половина — це випуск продукту.
API — це одні двері. Ось інші чотири, і кожні з них включені до тарифного плану, а не продаються як окремий рівень для розробників.
VS Code у браузері, відкритий зі сторінки сайту на панелі керування, редагує справжні файли цього сайту з вбудованим git і всім редактором у тій самій ізоляції CageFS, що й ваш доступ через SFTP. Він редагує РОБОЧИЙ сайт — проміжної тестової копії немає, тому збережений вами файл стає загальнодоступним у момент запису, хоча статичний файл може продовжувати надаватися з кешу CDN до чотирьох годин.
Безкоштовно, за ліцензією MIT і побудовано на цьому ж публічному API. Створіть структуру сайту WordPress, запустіть його на власному комп'ютері, виконайте попередню перевірку для слота, в який ви збираєтеся його розгорнути — версія PHP, диск, кількість файлів — і розгорніть. Потрібен Node 24 або новішої версії.
Єдиний каталог інструментів, завдяки якому клієнт штучного інтелекту, яким ви вже користуєтеся, може працювати з вашими сайтами через той самий API і ті самі дозволи, які використовує панель керування. Той самий сервер, до якого підключається ваш власний клієнт, підключено й до веб-редактора. Лише для читання, доки ви не вкажете інше.
Для роботи з клієнтами ваш пароль не потрібен. Запросіть когось за адресою електронної пошти, і він отримає доступ рівно до одного сайту: вони входять під своїм іменем із роллю переглядача, редактора або менеджера, а будь-який інший сайт повертає 404 ще до запуску будь-якого обробника — це політика безпеки на рівні рядків Postgres і бар’єр на рівні запитів, а не одна перевірка. Власник облікового запису надає та скасовує його в один клік, що набуває чинності з наступного запиту.
Ми надаємо платформу як хостинговий MCP-сервер: тонкий адаптер протоколу поверх API рушія, який повторно використовує той самий каталог дій, RBAC і журнал аудиту. Підключіть Claude Code, Cursor, ChatGPT, Claude Desktop або будь-який сумісний із MCP клієнт один раз, і кожна нова можливість, яку ми додаємо до API, стане автоматично доступною для нього.
Агент отримує три речі: Інструменти (ті самі кінцеві точки API, без паралельної логіки, яка могла б розбігатися), Ресурси (доступні лише для читання дані про стан сайту, конфігурацію, останні журнали, показники, час безвідмовної роботи та статті бази знань, тож він проводить діагностику на основі реальних даних перед початком дій) і Підказки (опубліковані шаблони робочих процесів, такі як «діагностувати цей сайт» або «підготувати міграцію»).
Безпека базується на тих самих принципах, що й автентифікація: OAuth 2.1, токени, прив'язані до вашої організації, та дозволи RBAC із застосуванням безпеки на рівні рядків, обмежені за областю дії та відкличні для кожного інструмента, а також пісочниця, відокремлена від робочого середовища. Деструктивні дії — видалення, призупинення, виставлення рахунків, значні витрати — вимагають явного підтвердження або політики схвалення людиною. Ліміти частоти запитів і ліміти витрат обмежують платні дії, ініційовані ШІ, а кожен виклик MCP фіксується в журналі аудиту із зазначенням ідентифікатора, інструмента, аргументів і результату.
Ми підтримуємо протокол, а не інтегруємо кожен застосунок окремо, що означає, що ваш вибір інструментів штучного інтелекту може змінюватися без зміни вашої інтеграції з хостингом.
Так — це той самий API рушія, опублікований і захищений. Панель керування, консоль адміністратора, CLI, провайдер Terraform, сервер MCP та вебхуки є споживачами одного інтерфейсу, саме тому API не відстає від панелі.
Так. Ключі пісочниці видаються окремо від робочих ключів і працюють у тестовому режимі: без реального виставлення рахунків і без реального надання ресурсів. Спрямуйте ваш CI на облікові дані пісочниці та безпечно відпрацюйте повний цикл запитів і відповідей.
Надсилайте Idempotency-Key у своєму POST-запиті. Запис повтору створюється під час фіксації (commit), а не лінійно (inline), тому повторна спроба ніколи не відтворить кешований успіх для рядка, який насправді не було зафіксовано, а запит, що зазнав помилки, негайно звільняє своє блокування, тож ваша виправлена повторна спроба не затримується. Доставка вебхуків за замовчуванням здійснюється за принципом «щонайменше один раз» (at-least-once) — виконуйте дедуплікацію за envelope id на своєму боці.
Не сьогодні. Ключі API видаються для кожної організації окремо, тому інтеграція, яка охоплює кілька клієнтських організацій, має ключ для кожної з них. Дозволи також перевіряються для кожної організації для суб'єктів-користувачів: наявність sites.create в одній організації не надає доступу в окремій, не пов'язаній організації, хоча застосовується до організацій, вкладених у неї. Це зроблено навмисно — скомпрометований ключ обмежується власною організацією та підпорядкованими їй суборганізаціями, а не всією платформою.
Роль dev охоплює перегляд даних організації, керування ключами API, перегляд і створення сайтів, їх перезапуск, очищення їх кешу, а також перегляд тікетів і відповіді на них. Вона навмисно виключає керування виставленням рахунків. Зверніть увагу, що дозволи на розгортання та публікацію не входять до неї — якщо вони потрібні учаснику команди, призначте роль, яка їх передбачає, замість того, щоб вважати Розробника найширшою технічною роллю.
Доставки повторюються з поступовим збільшенням інтервалу затримки, і кожна спроба записується як WebhookDelivery, яку ви можете перевірити. На вищих рівнях системи події записуються в транзакційну вихідну скриньку в тій самій транзакції бази даних, що й сама зміна, тому нічого не втрачається, поки споживач недоступний — споживач, який вийшов із ладу, відстає, але це ніколи не порушує роботу виробника, і ви можете повторно запустити доставки з панелі керування, щойно повернетеся.
Почніть із 14-денного пробного періоду Footprint-Free хостингу без банківської картки — жодних платіжних даних, до 5 сайтів. Платні тарифи Footprint-Free починаються від $6/міс. за PBN 5. Кожен план передбачає 30-денну гарантію повернення коштів, безкоштовне перенесення та відсутність прив'язки до постачальника.
API на основі специфікацій, згенеровані SDK, CLI, провайдер Terraform, підписані вебхуки та сервер MCP — на хостингу, який ми створили для понад 700 000 сайтів по всьому світу. Почніть із 14-денного пробного періоду без картки та платіжних даних.
Почати безкоштовноКожен із цих плагінів перетворює ваш сайт на WordPress на MCP-сервер, тож Claude, Cursor, VS Code та інші помічники зі штучним інтелектом можуть виконувати на ньому реальну роботу, увійшовши під вашим обліковим записом і з обмеженнями ваших прав доступу.