> For the complete documentation index, see [llms.txt](https://docs.nocodecloud.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nocodecloud.ru/nocodb/swagger/osnovy-i-avtorizaciya.md).

# Основы и авторизация

Swagger — это инструмент, который помогает разработчикам создавать, документировать и тестировать API (интерфейсы программирования приложений). Он автоматически генерирует описание для каждого ресурса в REST API, показывая доступные методы, параметры запросов и возвращаемые данные. Это делает документацию понятной как для людей, так и для машин, что упрощает взаимодействие между различными системами. Swagger позволяет разработчикам легко видеть структуру API и тестировать его методы прямо в браузере, что значительно ускоряет процесс разработки.

<figure><img src="/files/TK9XXdQGhjL6AIa8eBXZ" alt=""><figcaption></figcaption></figure>

Основная ценность Swagger заключается в его интерактивности и удобстве. С помощью Swagger UI пользователи могут не только просматривать документацию, но и отправлять тестовые запросы к API, получая мгновенные ответы. Это позволяет быстро проверять работоспособность методов и проводить отладку. Благодаря своей популярности, Swagger стал стандартным инструментом для работы с API и используется разработчиками, тестировщиками и аналитиками для упрощения процессов создания и поддержки программных интерфейсов.

{% hint style="info" %}
Тестовые запросы к API выполняются не в тестовой среде, а в реально существующих таблицах.

Поэтому их также можно воспринимать как ручные манипуляции с данными.

Если в результате теста в ваших таблицах появятся ненужные данные, их также можно удалить или изменить обратно, используя тестовые запросы, либо прямо в интерфейсе NocoDB.
{% endhint %}

## Как открыть Swagger

Чтобы открыть Swagger в NocoDB, нужно в левой панели навести курсор мыши на любую базу, затем нажать на “…” и выбрать “Swagger: REST APIs”.

<figure><img src="/files/9aaoxUOyqJHIqQbALFjg" alt=""><figcaption></figcaption></figure>

## API Token и авторизация в Swagger

Чтобы делать запросы в Swagger и не только (например, [HTTP-запросы](https://docs.smartbotpro.ru/scenarii/integracii/http-zaprosy)), в заголовках нужно указывать данные авторизации.

1. В NocoDB в левой панели откройте раздел “Team & Settings”.

   <figure><img src="/files/Dt97c43Miobtu0nuL0ZC" alt=""><figcaption></figcaption></figure>
2. В “Tokens” нажмите “Create new token”.

   <figure><img src="/files/NAnbauqsv6wAERzbEFlB" alt=""><figcaption></figcaption></figure>
3. Введите любое название токена и создайте его.

   <figure><img src="/files/M6YZNKjqgEZ1Js9bv2wa" alt=""><figcaption></figcaption></figure>
4. Скопируйте токен.

   <figure><img src="/files/SE2a5ik9Usfklfj7v0Hq" alt=""><figcaption></figcaption></figure>
5. Вернитесь в Swagger и нажмите “Authorize”.

   <figure><img src="/files/vwtwkT6ANcQqNy9Mchgu" alt=""><figcaption></figcaption></figure>
6. Вставьте токен и снова нажмите “Authorize”.

   <figure><img src="/files/BoBVND9yY7PnTLGeX0iq" alt=""><figcaption></figcaption></figure>
7. Если в окошке авторизации появилась надпись “Authorized”, значит, вы успешно авторизованы.

   <figure><img src="/files/AcWLKIl9pHeEr77urFfB" alt=""><figcaption></figcaption></figure>