--- title: "Руководство по API для операторов" slug: "using-the-operator-api" updated: 2026-10-22T14:34:05Z published: 2026-10-22T14:34:05Z canonical: "support.tulip.co/using-the-operator-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Руководство по API для операторов *Узнайте, как настроить API для операторов* Advanced Content This article assumes previous experience with APIs. Добавление операторов на ваш сайт необходимо для создания списка пользователей, которые будут запускать приложения, разработанные в Tulip. Создать операторов можно двумя способами:* [На странице «Пользователи»](https://support.tulip.co/docs/adding-users-and-managing-user-roles), расположенной в **разделе «Настройки»*** С помощью внешней системы через API Tulip. В приведенной ниже инструкции показано, как использовать API Tulip для создания операторов. ## Добавление токена API оператора Feature rename Prior to r383, Service Accounts were called "API Tokens". В вашем экземпляре Tulip нажмите на **значок профиля** в правом верхнем углу и выберите **«Настройки**». ![Configuring Your Tulip Account Settings_124925135](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Configuring%20Your%20Tulip%20Account%20Settings_124925135.png) Выберите **«API Tulip»**, затем нажмите кнопку **«Создать служебную учетную запись** » в правом верхнем углу. ![Create%20API%20token1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png) В меню «Создание» присвойте токену API **имя** и выберите область действия `users:write`. Нажмите **«Создать**». ![Create API Token](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20Token.gif) Note Make sure to save the Service Account information for the **API Key**, **Secret**, and **Authorization Header**. ## Использование API оператора Ниже описано, как создать оператора. В данном примере для создания будет использоваться [Postman](https://www.postman.com/). Сначала добавьте конечную точку API в запрос POST. NOTE If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional. *https://(yourinstancenamehere).tulip.co/api/v3/w/(workspace)/users* ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222496924.png) Затем в разделе «Авторизация» выберите **«Базовая авторизация»** и введите ключ API в поле **«Имя пользователя**», а секретный ключ API — в поле **«Пароль**». ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) В разделе «Заголовки» добавьте **заголовок «Auth**». ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497957.png) В поле «Тело» (Body) отформатируйте запрос так, чтобы он принимал объект JSON. Общий формат этого запроса выглядит следующим образом. `{"role": "operator","name": "string","badge_id": "string"}` Это будет выглядеть примерно так: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499033.png) Нажмите **«Отправить»**, чтобы отправить запрос, и вы получите ответ 201, подтверждающий успешное выполнение. Для проверки вы можете зайти в **«Настройки»** и посмотреть список пользователей, чтобы убедиться, что пользователь был успешно создан. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499593.png) Если запрос завершился с ошибкой, проверьте правильность ключа и секретного ключа. Дополнительную информацию о конкретных кодах ответов см. в разделе [«Введение в API](/r230/docs/introduction-to-apis)». --- Нашли ли вы то, что искали? Вы также можете перейти на [сайт community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all), чтобы задать свой вопрос или посмотреть, сталкивались ли другие пользователи с подобной проблемой! **JSON** **JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.