Използвайте API на Airtable с Artavolo
Обновено
Artavolo отговаря на REST API на Airtable на същите пътища, със същите идентификатори и същия JSON. Скрипт, библиотеката Airtable.js или HTTP стъпка, написана за Airtable, продължава да работи, щом смените две неща: адреса и токена.
Насочете скрипт към Artavolo
- Създайте API токен на Artavolo за работното пространство, което съдържа базата. Вижте Използване на REST API и API токени.
- Заменете
https://api.airtable.comсhttps://artavolo.comили с адреса на вашия собствен сървър. - Заменете токена на 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 по всяко време.