Как найти ID базы данных и таблицы Baserow для API

Каждый запрос к REST API Baserow и каждый вебхук адресуются по числовому идентификатору базы данных или таблицы, а не по их названию - в статье собраны все способы найти эти ID: через адресную строку браузера, меню таблицы, настройки токенов и автоматически сгенерированную API-документацию.

Что такое ID базы данных и таблицы

ID базы данных и таблицы - это уникальные числовые идентификаторы, которые Baserow присваивает каждой созданной базе данных и каждой таблице внутри неё. Эти номера служат точными ссылками при работе с REST API Baserow , настройке вебхуков или подключении сторонних интеграций - например, Zapier, Make или n8n.

В отличие от названий, которые можно изменить в любой момент, ID остаются неизменными на протяжении всего существования базы данных или таблицы - это делает их надёжными идентификаторами для автоматизации и интеграций.

Как найти ID базы данных

Есть несколько способов узнать ID базы данных в Baserow.

Способ 1: адресная строка браузера

Когда открыта любая таблица внутри базы данных, посмотрите на адрес в браузере. URL самостоятельно размещённого (self-hosted) инстанса Baserow строится по шаблону:

https://<ваш-домен-baserow>/database/12345/table/678901/234567

В этом примере 12345 - это ID базы данных.

Способ 2: API-документация базы данных

1. Откройте нужную базу данных.
2. Нажмите на значок ⋮ рядом с именем базы данных.
3. Выберите Просмотреть API-документацию.
4. ID базы данных будет виден прямо в документации.

Как найти ID таблицы

Есть несколько способов узнать ID таблицы в Baserow.

Способ 1: через токены базы данных

1. Нажмите на название рабочего пространства в левом верхнем углу.
2. Выберите Настройки -> Токены базы данных.
3. Нажмите на нужный токен.
4. Выберите Показать базы данных.
5. ID таблиц будут перечислены рядом с их названиями.

Подробнее о создании и области действия токенов - в статье «Персональные токены доступа» .

Способ 2: API-документация базы данных

Так же, как и для ID базы данных, API-документация показывает ID всех таблиц внутри базы.

1. Откройте настройки базы данных.
2. Найдите ссылку Просмотреть API-документацию.
3. Baserow автоматически формирует документацию с ID всех таблиц и структурой их полей.

GET https://<ваш-домен-baserow>/api/database/tables/database/DATABASE_ID/
Authorization: Token YOUR_API_TOKEN

Ответ содержит все таблицы базы данных вместе с их ID.

Способ 3: меню настроек таблицы

1. Нажмите на значок ⋮ рядом с названием любой таблицы.
2. ID таблицы отображается в скобках рядом с названием таблицы.
3. Пример: «Клиенты (12345)», где 12345 - это ID таблицы.

Способ 4: адресная строка браузера

1. Откройте таблицу, которую нужно подключить в Baserow.
2. Посмотрите на адрес в браузере.
3. Структура URL: https://<ваш-домен-baserow>/database/DATABASE_ID/table/TABLE_ID/...
4. Извлеките число после /table/.

Пример:

URL: https://<ваш-домен-baserow>/database/456/table/12345/grid
TABLE_ID: 12345

Когда нужны ID базы данных и таблицы

Эти идентификаторы обычно требуются в следующих случаях:

• при API-запросах для получения, создания или изменения данных;
• при настройке вебхуков , которые запускают действия при изменении данных;
• при настройке интеграций с Zapier, Make, n8n и другими инструментами автоматизации;
• при разработке собственных приложений, подключающихся к данным Baserow;
• при передаче доступа к конкретной базе данных или таблице разработчикам.

Сравнение: ID базы данных и ID таблицы

Часто задаваемые вопросы

Что происходит с ID при переименовании базы данных или таблицы? ID базы данных и таблицы никогда не меняются, даже при переименовании. Это гарантирует, что интеграции и API-запросы продолжат работать без перерыва.

Можно ли использовать один и тот же ID на разных инстансах Baserow? Нет, ID уникальны в пределах одного инстанса Baserow. При переносе данных между разными self-hosted установками ID будут отличаться.

Нужны ли особые права, чтобы увидеть ID базы данных и таблицы? Для просмотра ID достаточно роли с доступом на чтение. Однако для использования ID в API-запросах потребуются права, соответствующие конкретным операциям, которые нужно выполнить.

Есть ли риски при передаче этих ID третьим лицам? Сами по себе ID базы данных и таблицы не дают доступа к данным. Однако в сочетании с токеном базы данных они открывают доступ к информации. Передавайте ID только доверенным сторонам и всегда используйте корректную аутентификацию.

Можно ли задать собственный ID базы данных или таблицы? Нет, Baserow автоматически присваивает последовательные ID при создании баз данных и таблиц. Задать или предсказать эти номера нельзя.

Дальше пригодится статья «REST API Baserow» - там разобраны эндпоинты, аутентификация и структура запросов для работы с данными таблиц через HTTP.