За софтуерни екипи
Вградете в продукта си електронни таблици, които потребителите ви управляват
Таблици, които потребителите могат да сортират, филтрират и преустройват. Дъски, календари и формуляри върху същите записи. Да изградите това както трябва е година работа; да го вградите е въпрос на един следобед, а клиентите ви не напускат вашия продукт, за да го ползват.
Същите данни, поискани с едно изречение
Вашата инсталация говори Model Context Protocol, така че Claude, ChatGPT или всичко друго, което го поддържа, може да чете и променя записите, до които клиентът ви вече има достъп. Свързва се директно с вашия сървър. Нищо не се копира другаде.
Какво вграждате
Работещо приложение, а не просто джаджа.
Изгледи, които създават вашите потребители
Таблица, карти, Канбан и календар върху същите записи, с филтриране, сортиране, групиране и скрити колони в лентата с инструменти.
Истински релации
Насочете колона към друга таблица, изберете от нейните записи и оставете избора да попълни съпътстващите колони. Не плоска таблица, която се преструва на база данни.
Автоматизации и уебхукове
Правила по график и по събитие, изходящи уебхукове със собствени имена на заглавки и REST API за всичко останало.
Формуляри
Публични или с вход формуляри за подаване, валидиране, качване на файлове, незадължителна парола.
Права, които издържат
Видимост на ниво работно пространство, база и лист; собственик, сътрудник и само за четене; гости. Прилага се на сървъра, при всяка заявка.
Одитна следа
Дневник само с добавяне на това кой коя клетка е променил, кога и откъде, включително действията във вградените ви изгледи, под вашите собствени потребителски имена.
От нищо до вграден изглед
Шест стъпки, около двадесет минути, без SDK за инсталиране и без стъпка за компилиране. Следвайте ги по ред първия път; след това са три реда ваш собствен код.
-
Пуснете Artavolo
Една команда на Docker или PHP и MySQL на обикновен хостинг - вижте Изтегляне. Влезте като администратора, когото създадохте. (2 минути)
-
Решете от чие име действа вграденият изглед
Токенът за вграждане винаги сочи реален потребител на Artavolo и никога не може да прави повече от него. Създавайте го целенасочено - Администрация → Членове - например
embed@yourcompany.com, после отворете базата, която искате да вградите, и дайте на този потребител точно достъпа, който трябва да имат клиентите ви: само за четене или за редактиране. (3 минути) -
Включете вграждането
Администрация → Настройки → Вграждане: отбележете Приемане на токени за вграждане, добавете адреса, на който работи приложението ви, под Разрешени произходи на хост (например
https://app.yourcompany.com, илиhttp://localhost:3000докато разработвате), и копирайте тайна за подписване. Пазете тази тайна на вашия сървър. (2 минути)Същият екран има Опитайте сега поле: изберете една от вашите бази и то ви дава връзка за отваряне и iframe за поставяне, така че да видите вграден изглед, преди да напишете ред от това.
-
Подпишете токен в собствения си бекенд
Четири реда. Това е единственият специфичен за Artavolo код, който ще напишете - или инсталирайте Node клиента, който идва с изтеглянето ви (
npm install ./deploy/packages/artavolo-embed) и извикайтеcreateEmbedToken(), който прави същото, като включва компоненти за React и Vue.$payload = json_encode([ 'v' => 1, 'mid' => 42, // the Artavolo user from step 2 'did' => 7, // which base 'tid' => 0, // the sheet to open, or 0 for the whole base 'mode' => 'write', // or 'read' 'exp' => time() + 600, // valid for ten minutes 'act' => 'jane@yourcompany.com', // your user, for the audit log 'jti' => bin2hex(random_bytes(8)), ]); $b64 = fn($d) => rtrim(strtr(base64_encode($d), '+/', '-_'), '='); $token = 'ARTE1.' . $b64($payload) . '.' . $b64(hash_hmac('sha256', $payload, $secret, true));Същите четири реда на Node, Python или каквото и да е друго - това е само base64url и HMAC-SHA256. Подписвайте точно тези байтове, които изпращате.
-
Сложете го в страницата си
<iframe id="artavolo" src="https://data.yourcompany.com/base/BASE_CODE/embed?et=<?= $token ?>" style="width:100%;border:0"></iframe>BASE_CODEе кодът в собствения адрес на базата. Заредете страницата: потребителите ви гледат данните си и никога не са виждали вход. -
Слушайте за две съобщения
Така рамката сама си намира размера, а вашият екран остава в синхрон.
window.addEventListener('message', (event) => { if (event.origin !== 'https://data.yourcompany.com') return; const message = event.data; if (!message || message.source !== 'artavolo') return; if (message.type === 'height') frame.style.height = message.payload.height + 'px'; if (message.type === 'rows.changed') refreshMyOwnView(); });
Може да прави винаги по-малко от профила, който назовава
Вградената сесия е ограничена до базата или листа, посочени в токена, до фиксиран списък от действия с данни - без настройки, без членове, без администриране - и до четене, освен ако токенът не казва друго write. Насочете го към акаунт с точно онези права, които трябва да имат клиентите ви, и този таван се прилага при всяка заявка.
Работещ пример
Готови хост приложения, които можете да пуснете веднага: един файл на PHP или Node (embed-host), приложение с Vite (embed-vite) и десктоп приложение с Electron (embed-electron).
Справочникът за вграждане
Всяко съобщение, всяко поле на токена, моделът на сигурност и таблица за отстраняване на проблеми: docs/embedding.md във версията.
REST API
Всяка крайна точка и всеки параметър, когато искате да управлявате данните, а не само да ги показвате.
Отворете справочника за APIДоставяте настолно приложение?
Работи по същия начин в Electron, Tauri и WebView2 - има работещ пример с Electron в deploy/examples/embed-electron/. Една разлика: прозорец, чиято страница се зарежда от file:// няма произход, така че не може да му се позволи да вгражда нищо. Сервирайте прозореца си от собствена схема или от локален адрес и разрешете него. docs/embedding-desktop.md съдържа измерените резултати за всеки.
Ако нещо не се появи
- Празна рамка - адресът ви не е в Разрешени произходи на хост.
- “Подписът не съвпада” - грешна тайна или JSON е бил прекроен след подписването.
- “Токенът е изтекъл” - проверете часовника на сървъра си.
- “Само за четене” - токенът казва
mode: read.
Лицензи
Вграждането на Artavolo във ваш собствен продукт се оферира отделно, с White-label или Enterprise. Разкажете ни какво изграждате.
За марки и по-големи организации
Оферта по имейл, обикновено до един работен ден. Не е нужен разговор.
White-label
върху всеки платен план, на инсталация
Вашата собствена марка върху него, за вашата компания или за клиентите, за които го поддържате.
- Вашето име, лого и favicon навсякъде
- Вашият адрес на изпращача на имейлите
- Вашето име в AI конектора и в заглавията на уебхуковете
- Собствен домейн
- Никъде няма “powered by”
- На ваш сървър или на отделна инсталация, която поддържаме ние
Enterprise
на организация, в облака или на ваши сървъри
Прегледи на сигурността, договори и мащаб: нещата, които голямата организация иска на писмо.
- Всичко от Pro
- Единен вход (OpenID Connect: Entra ID, Okta, Google)
- Отделна инсталация в избрана от вас държава от ЕС или във вашата собствена мрежа
- Попълнен въпросник за сигурност и индивидуални условия
- Времена за отговор и достъпност, записани в договора
- Цени за по-голям обем или една цена за цялата организация
- Включено преминаване от Airtable
За да го опитате първо, безплатният Общностна версия няма ограничения за потребители и записи и не изисква регистрация. Всеки план, в нашия облак или на ваш сървър, е на страницата с цените.
Започнете с кода, а не с разговор с търговец
Изтеглете го, стартирайте го с една Docker команда, вградете го в тестова страница и решете. Ако после поискате лиценз, достатъчен е един имейл.