Airtable

Для полноценной настройки интеграции нам понадобится пройти всего пять этапов:

Регистрация в Airtable
Настраиваем таблицу
Получение токена для запросов
Хранение токена в проекте Multy
Настройка схемы

Регистрация в Airtable:

Регистрируемся на сайте
Нажимаем "Create"

Выбираем нужный Workspace и жмем "Start from scratch"

Настраиваем таблицу

Настраиваем нужные ячейки:

Для редактирования кликаем по ячейке и меняем название. Например: Имя: вместо Name

Кратко пробежимся по типам полей:

Single line text - однострочный текст.
Long text - длинный текст для абзацев.
Date - для записи даты
Phone number - для номера телефона
Email - для записи электронной почты
Url - для хранения ссылок

Все остальные типы интуитивно понятны. Выбрав тип не забудьте нажать "Save"

Пример настроенной заполненной таблице выше.

Получение токена для запросов

Для получения токена переходим по ссылке:

Там все интуитивно понятно. Главное выбрать нужную базу в примере Multy и выбрать методы для записи с типом write

data.records:write

Важно!

Если вы не выберете к какой базе будет иметь доступ данный токен, то он не будет работать. Базы выбираются в поле Access.
Если нужен доступ ко всем базам (на свой страх и риск) выбираем в Access "All current and future bases in all current and future workspaces"

Сервис Multy.AI рекомендует хранить токены в глобальных переменных проекта, подальше от посторонних глаз, потому что используя ваш токен можно видоизменять / удалять вашу таблицу.

Получив токен скопируйте его в блокнот и нажмите "Done"

Пример токена на скрине:

Для работы с API открываем соответствующий раздел. Пример ссылки: https://airtable.com/appGN7WSZmmfaBj61/api/docs#curl/table:table%201:create

и копируем адрес для запросов: Пример:

curl -X POST https://api.airtable.com/v0/appGN7WSZmmfaBj61/Table%201 \

Жирным выделен адрес для запросов.

Хранение токена в проекте Multy

Создаем глобальную переменную в соответствующем разделе. Для работы блок-схемы название не менять

Системное имя: airtable_key

Настраиваем блок-схему

Создаем действие "Отправить запрос на внешний сайт"
Вставляем наш скопированный ранее URL
Метод отправки выбираем "FORM POST"
Формат результата выбираем "JSON"
Нажимаем галочку "Добавить параметры запроса" и добавляем нужные параметры из примеров ниже.
Если необходимо ставим галочку "Настроить частотные ограничения" и ставим 1000 (рекомендуемые лимиты можно узнать в документации Airtable)
При необходимости, или для тестирования, ставим галочку "Сохранить результат в переменную" и указываем свою переменную. Например response
Для сохранения ID записанной строки рекомендуется сохранять ее в переменную, например, {var:air_id} со значением:
```
{var:response.id}
```
Если переменная {var:air_id} не равна undefined- значит Airtable вернул ID записанной строки. Ее можно записывать в поля игрока для последующей работы.

Параметры запроса:

fields.Имя: - здесь название ячейки указывается после fields.

fields.Фамилия: - здесь название ячейки Фамилия указывается после fields.

fields.Оплата: - здесь признак покупки указывается в формате true/false.

Заголовки запроса;

Authorization со значением:

Bearer {var:airtable_token}

где в переменной {var:airtable_token} хранится токен из глобальной переменной

Формат передачи данных: JSON

Например: {user:first_name} {user:last_name} - передаст в таблицу имя и фамилию пользователя в две первых ячейки.

Пример простой настройки для добавления данных в новую строку:

Пример редактирования строки

Здесь в {var:table} записанная ID строки для пользователя

Пример удаления строки

Здесь в {var:table} записанная ID строки для пользователя

Для нетерпеливых схема.