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

> Идентификаторы базы данных и таблицы Baserow - числа для API-запросов и вебхуков: разбираем, где их искать через URL, меню и API-документацию.

Source: https://opennix.org/docs/baserow/webhook-api/database-and-table-id/


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

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

ID базы данных и таблицы - это уникальные числовые идентификаторы, которые Baserow присваивает каждой созданной базе данных и каждой таблице внутри неё. Эти номера служат точными ссылками при работе с [REST API Baserow](/docs/baserow/webhook-api/database-api/), настройке [вебхуков](/docs/baserow/webhook-api/webhooks/) или подключении сторонних интеграций - например, 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 таблиц будут перечислены рядом с их названиями.

Подробнее о создании и области действия токенов - в статье [«Персональные токены доступа»](/docs/baserow/webhook-api/personal-api-tokens/).

### Способ 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 таблицы.

![ID таблицы в меню настроек таблицы](/images/baserow/webhook-api/database-and-table-id-table-options.jpg)

### Способ 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-запросах для получения, создания или изменения данных;
- при настройке [вебхуков](/docs/baserow/webhook-api/webhooks/), которые запускают действия при изменении данных;
- при настройке интеграций с Zapier, Make, n8n и другими инструментами автоматизации;
- при разработке собственных приложений, подключающихся к данным Baserow;
- при передаче доступа к конкретной базе данных или таблице разработчикам.

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

| Параметр | ID базы данных | ID таблицы |
|---|---|---|
| **Область действия** | Вся база данных | Отдельная таблица |
| **Сценарий использования** | Операции на уровне базы данных | Операции с конкретной таблицей |
| **Эндпоинты API** | `/api/database/{id}/` | `/api/database/{db_id}/table/{table_id}/` |
| **Права доступа** | Доступ ко всей базе данных | Доступ к конкретной таблице |

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

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

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

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

**Есть ли риски при передаче этих ID третьим лицам?** Сами по себе ID базы данных и таблицы не дают доступа к данным. Однако в сочетании с [токеном базы данных](/docs/baserow/webhook-api/personal-api-tokens/) они открывают доступ к информации. Передавайте ID только доверенным сторонам и всегда используйте корректную аутентификацию.

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

Дальше пригодится статья [«REST API Baserow»](/docs/baserow/webhook-api/database-api/) - там разобраны эндпоинты, аутентификация и структура запросов для работы с данными таблиц через HTTP.