Напускате Airtable? Пренесете базите си в Artavolo, проверени запис по запис. Вижте как

Вградете Artavolo във ваше собствено приложение

Обновено

Вашето собствено приложение може да показва таблица, дъска, календар или формуляр на Artavolo в страниците си. Вашите потребители работят със записите, редактират ги, ако позволите, и никога не виждат екран за вход. Вашият сървър подписва токен с кратък живот, който назовава акаунт в Artavolo и база; рамка във вашата страница се отваря с него.

Как работи

Токенът назовава акаунт в Artavolo, базата, по желание единствената таблица за отваряне, дали може да записва, и етикет за вашия собствен потребител. Вградената сесия винаги може да прави по-малко от този акаунт: без настройки, без членове, без права, без импорт, без администрация и нищо извън базата или таблицата в токена. Всяка заявка се проверява спрямо токена, така че работи дори там, където браузърите блокират бисквитките на трети страни.

Първо вижте как работи

  1. Отворете администрацията (Контролен панел в менюто на акаунта), после Настройки, Вграждане.
  2. Под Опитайте сега изберете една от вашите бази, таблица или Цялата база, и Само за четене или Четене и запис.
  3. Натиснете Генерирай и отворете връзката. Това е вграден изглед, който действа от ваше име, за десет минути.

Същото поле след това отпечатва кода с адреса на вашата инстанция, акаунта и базата вече попълнени, за PHP, за Node или за демонстрационната команда.

Настройте го наистина

  1. Създайте акаунта в Artavolo, от чието име ще действа вграденият изглед, и му дайте точно достъпа, който трябва да имат вашите потребители. Не използвайте администратор.
  2. В Настройки, Вграждане, отметнете Приемай токени за вграждане.
  3. Добавете адреса на вашето приложение под Разрешени адреси на хостове, по един на ред, например https://app.example.com. Всеки друг сайт се отхвърля.
  4. Копирайте Тайния ключ за подписване на вашия сървър. Никога не го поставяйте в код за браузър.
  5. На вашия сървър подпишете токен при всяко зареждане на страница и го сложете в адреса на рамката. Ръководството за вграждане съдържа формата на токена и работещ код на PHP, Node и Python, както и клиентски пакет с обвивки за React и Vue.

Докато работи

Рамката казва на вашата страница кога е готова, колко висока трябва да бъде и кога се променят записи, така че вашите екрани да остават в синхрон. Вашата страница може да поиска от нея да се презареди.

Добре е да знаете

  • Настройването изисква администраторски достъп до инстанцията, затова се прави на ваш собствен сървър или на специална инстанция. На ваш собствен сървър е нужен лицензен ключ, който включва вграждане; то се предлага с White-label или Enterprise.
  • Без white-label вграденият изглед запазва малък надпис „powered by“.
  • Токените трябва да са с кратък живот: издавайте нов при всяко зареждане на страница. Сесията в рамката след това трае колкото сесията на браузъра, така че никой не се прекъсва по средата на редактиране.
  • Всяка вградена сесия е в дневника на промените с вашия етикет за потребителя, така че промените могат да се проследят до вашите собствени потребители.
  • Смени до тайния ключ за подписване отхвърля веднага всеки токен, подписан със стария.
  • Празна рамка обикновено означава, че вашият адрес липсва в Разрешени адреси на хостове. Грешка в подписа означава грешен таен ключ, а изтекъл токен често означава неточен часовник на сървъра.
  • Работят и настолни приложения (Electron, Tauri, WebView2); ръководството обяснява единственото, което е различно.
  • За публичен изглед само за четене на уебсайт гостовият достъп е по-прост. Вижте Показване на база на уебсайт.

Свързани