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

Използвайте REST API и API токени

Обновено

REST API позволява на програма да прави онова, което човек прави на екрана: да изброява, чете, създава, променя и изтрива записи и да чете как е устроена една база. Програмата влиза с API токен, който действа като вас, с вашите права, в едно работно пространство.

Създайте токен

  1. Отворете менюто под инициалите или снимката си и изберете Моят акаунт.
  2. Под API токени натиснете Управление на токените.
  3. Натиснете Добави нов токен, въведете Заглавие, което казва коя програма ще го използва, и изберете Работно пространство.
  4. Натиснете Създай токен.
  5. Копирайте токена от зелената кутия, която се появява, и го пазете на сигурно място. Показва се само този път: Artavolo пази само отпечатък от него, така че никой, дори ние, не може да го прочете отново. Загубихте ли го? Използвайте Генерирай нов токен.

Изберете до кои бази достига токенът

  1. В Управление на токените натиснете молива под токена.
  2. Изключете Разрешено за всяка база, от която програмата няма нужда. Превключвателят най-горе изключва целия токен.
  3. Натиснете Запиши.

В същото меню има Преименувай, Генерирай нов токен (старата стойност спира да работи, а новата се показва веднъж) и Премахни.

Извикайте API

Изпращайте токена в заглавка API-KEY или използвайте Basic автентикация с вашия имейл адрес като потребителско име и токена като парола. Записите се изпращат като JSON.

  • API за данни има един ресурс за всяка таблица под /api/v2/bases/{code}/tables/{table}/rows, където {code} е кодът от адреса на базата. Четенето връща до 10 000 записа на страница (по подразбиране 100) и може да филтрира, сортира, търси и групира. Една заявка може да създаде до 100 записа.
  • API, съвместимо с Airtable, отговаря на собствените пътища на Airtable на /v0, така че скриптовете, писани за Airtable, продължават да работят.

Запис през API прави същото като същата промяна на екрана: следва правилата на базата за това кой може да добавя, променя и изтрива, записва се в дневника на промените, стартира автоматизациите на таблицата и изпраща уебхуковете на базата. Изтрит запис отива в кошчето на таблицата за 30 дни.

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

  • Токенът може да прави само онова, което можете вие. Ако сте член само за четене на база, такъв е и токенът. Когато някой напусне работно пространство, и неговите токени спират да работят там.
  • Третирайте токена като парола: пазете го на сървър, никога в уеб страница, мобилно приложение или хранилище с код. Ако може да е изтекъл, използвайте Генерирай нов токен или Премахни.
  • Дайте на всяка програма собствен токен, за да можете да изключите един, без да спирате другите.
  • В нашия облак един токен може да изпраща 600 заявки в минута, а цяло работно пространство 3000. Над това отговорът е 429 със заглавка Retry-After. На собствен сървър няма ограничение, освен ако администратор не зададе такова.
  • Полетата с формула, справка, обобщение и AI са само за четене през API. Файловете се качват отделно, не се записват като стойности.
  • Асистенти като Claude и ChatGPT се свързват през AI конектора, който има собствени връзки; те са изброени под Свързани асистенти в същия прозорец. Токен на AI конектора се отхвърля от API за данни.

Свързани