Използвайте REST API и API токени
Обновено
REST API позволява на програма да прави онова, което човек прави на екрана: да изброява, чете, създава, променя и изтрива записи и да чете как е устроена една база. Програмата влиза с API токен, който действа като вас, с вашите права, в едно работно пространство.
Създайте токен
- Отворете менюто под инициалите или снимката си и изберете Моят акаунт.
- Под API токени натиснете Управление на токените.
- Натиснете Добави нов токен, въведете Заглавие, което казва коя програма ще го използва, и изберете Работно пространство.
- Натиснете Създай токен.
- Копирайте токена от зелената кутия, която се появява, и го пазете на сигурно място. Показва се само този път: Artavolo пази само отпечатък от него, така че никой, дори ние, не може да го прочете отново. Загубихте ли го? Използвайте Генерирай нов токен.
Изберете до кои бази достига токенът
- В Управление на токените натиснете молива под токена.
- Изключете Разрешено за всяка база, от която програмата няма нужда. Превключвателят най-горе изключва целия токен.
- Натиснете Запиши.
В същото меню има Преименувай, Генерирай нов токен (старата стойност спира да работи, а новата се показва веднъж) и Премахни.
Извикайте 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 за данни.