Готові застосунки

Кожен з трьох це робочий застосунок, а не фрагмент коду: форма, сервер, малюнок і відповідь API. Клонуйте, покладіть ключ у .env, запустіть. Код під MIT, тож забирайте його у свій продукт без умов.

Усі три влаштовані однаково: Vite на фронтенді й один маленький сервер на Node, через який ідуть виклики. Браузер не може звернутися до API напряму, тож ключ живе на сервері й на сторінку не потрапляє.

git clone https://github.com/astroway/starter-human-design
cd starter-human-design && npm install
cp .env.example .env     # ваш ключ сюди
npm run dev

Ключ отримаєте в дашборді. Поки будуєте, беріть пісочний aw_test_*: він не витрачає кредитів.

Human Design

Дата, час і місце народження на вході, бодиграф і розбір на виході. Один виклик POST /v1/human-design віддає тип, стратегію, авторитет, профіль, визначення, хрест втілення, дев’ять центрів з активними воротами, усі визначені канали й обидва набори активацій. Застосунок малює бодиграф на SVG і таблицю активацій. 50 кредитів за читання, тобто 200 читань на безкоштовному тарифі.

Живе демо

Код на GitHub

Розгорнути на Render

BaZi

Чотири стовпи долі й цикл удачі. POST /v1/bazi/chart віддає стовпи з прихованими стеблами, на інь і фазу дванадцяти стадій, господаря дня, баланс стихій, вердикт сили з поясненням, символічні зірки й усі поєднання та зіткнення гілок. POST /v1/bazi/luck-pillars віддає Да Юнь: напрямок, вік початку й десять стовпів по десять років. Обидва виклики йдуть паралельно, 30 кредитів за читання.

Живе демо

Код на GitHub

Розгорнути на Render

Кабінет звітів

Для практика: дані клієнта на вході, готовий PDF з вашим брендом на виході. Шістнадцять звітів під одним префіксом POST /v1/reports/<type>, кожен приймає блок whitelabel, тож файл, який отримує клієнт, носить ваше ім’я, а не наше. П’ятнадцять звітів коштують 5000 кредитів, таро 100.

Живе демо

Код на GitHub

Розгорнути на Render

Заувага

Демо обмежені за адресою й ходять власними ключами з доступом лише до своїх ендпоінтів. Демо кабінету звітів рендерить тільки таро, бо сторінка у відкритому інтернеті, що робить звіт за 5000 кредитів кожному, витратила б місячний безкоштовний тариф за два кліки. Ваша копія рендерить усі шістнадцять.

Розгортання

Кнопка Render читає render.yaml у репозиторії: один веб-сервіс на Node на безкоштовному плані, який збирається й стартує скриптами з package.json. При створенні Render попросить ключ API. Будь-який хостинг, де працює Node 22, підходить так само: зібрати, запустити, задати ключ.