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

Използвайте API на Airtable с Artavolo

Обновено

Artavolo отговаря на REST API на Airtable на същите пътища, със същите идентификатори и същия JSON. Скрипт, библиотеката Airtable.js или HTTP стъпка, написана за Airtable, продължава да работи, щом смените две неща: адреса и токена.

Насочете скрипт към Artavolo

  1. Създайте API токен на Artavolo за работното пространство, което съдържа базата. Вижте Използване на REST API и API токени.
  2. Заменете https://api.airtable.com с https://artavolo.com или с адреса на вашия собствен сървър.
  3. Заменете токена на Airtable с токена на Artavolo. Изпраща се по същия начин: Authorization: Bearer <token>.

При Airtable.js това са apiKey и endpointUrl, които подавате на new Airtable(). Заявка за списък изглежда така: GET https://artavolo.com/v0/appXXXXXXXXXXXXXX/Tasks?filterByFormula={Status}='Done'.

Идентификаторите остават същите

База, пренесена с импортера на Airtable, запазва идентификаторите на Airtable: идентификатора на базата app..., на всяка таблица tbl..., на всяко поле fld... и на всеки запис rec.... Запазените идентификатори на записи и връзки във вашите системи продължават да сочат към същите записи. Можете да назовавате таблица или поле и по име. Запис, създаден в Artavolo, получава идентификатор, който започва с recAV.

Какво отговаря

  • Записи: списък (с pageSize до 100, offset, fields[], sort, view и filterByFormula), четене на един, създаване, обновяване с PATCH или PUT и изтриване, до 10 записа на заявка както в Airtable.
  • Мета API: /v0/meta/whoami, /v0/meta/bases и /v0/meta/bases/{base}/tables, с типове полета, назовани както ги назовава Airtable. Интеграционните инструменти ги използват, за да попълнят избирачите си на бази, таблици и полета.
  • Проверка за промени: сортирайте по CREATED_TIME() или LAST_MODIFIED_TIME() без собствено поле за време и искайте само това, което се е променило, с createdAfter или modifiedAfter.
  • Абонаменти: /v0/hooks изпраща всяка промяна на таблица на адрес, който посочите, подписана с тайна. Вижте Свържете Zapier, Make или n8n.

Стойностите идват във формата на клетките на Airtable: единичен избор като име на опцията, връзки като идентификатори на записи, прикачени файлове с URL, име на файл, размер и тип. Грешките и 429 за твърде много заявки също идват във формата на Airtable, така че кодът, който вече ги обработва, изчаква правилно.

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

  • Собственикът на токена действа със собствените си права: ролите, скритите таблици и правилата за записи важат, всеки запис е в дневника на промените, а изтриванията отиват в кошчето.
  • filterByFormula поддържа сравнения, AND, OR, NOT, FIND, SEARCH, BLANK(), IS_BEFORE, IS_AFTER, IS_SAME и RECORD_ID(). Всичко друго се отхвърля с INVALID_FILTER_BY_FORMULA на Airtable и никога не се отговаря с по-широк списък.
  • Все още липсват: performUpsert, промяна на структурата на база през мета API (той само чете), собственият API за уебхукове на Airtable, коментарите към записи и cellFormat=string.
  • Всяка таблица може да се експортира и във форматите CSV и JSON на Airtable, така че можете да върнете данните си в Airtable по всяко време.

Свързани