--- title: "Тестирование API Tulip" slug: "testing-tulip-apis" updated: 2026-10-22T14:31:38Z published: 2026-10-22T14:31:38Z canonical: "support.tulip.co/testing-tulip-apis" --- > ## 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 Tulip Advanced Content This article assumes previous experience with APIs. Ознакомьтесь со статьями [«Таблицы»](https://support.tulip.co/r230/docs/an-overview-of-tables), [«Операторы»](https://support.tulip.co/r230/docs/using-the-user-api) и [«Машины»](https://support.tulip.co/docs/how-to-use-the-machine-attributes-api), чтобы узнать, как настроить ключ API. ### Используйте Tulip Connectors для тестирования API Tulip Feature rename Prior to r383, Service Accounts were called "API Tokens". Ознакомьтесь с [инструкциями по настройке коннектора](https://support.tulip.co/docs/how-to-configure-a-connector) и подключите его с помощью настроенной вами учетной записи службы API (см. [эту статью](https://support.tulip.co/docs/setting-up-the-table-api-for-the-library) о настройке учетной записи службы). После настройки коннектора нажмите «Создать функцию». В этом примере мы рассмотрим, как получить записи из таблицы. Сначала необходимо сформировать запрос с использованием методов GET, POST, PUT, HEAD, PATCH или DELETE, а затем указать конкретный URL-адрес, по которому вы хотите отправить запрос ([подробнее о возможностях нашего API читайте здесь)](https://tulip.co/developer/tulip-api-docs/) . ![Screenshot 2024-02-28 at 2.35.15 PM.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202024-02-28%20at%202.35.15%20PM.png) NOTE If you are using a global Service Account, you need to specify the workspace. If your Service Account is workspaced scoped, it is optional. *https://(yourinstancenamehere).tulip.co/api/v3/w/(workspace)/tables/(TableID)/records* Обязательно добавьте данные аутентификации (из самой учетной записи службы), заголовки запроса (при необходимости) и параметры запроса (либо в самом URL-адресе, либо в параметрах запроса — [подробнее о настройке параметров запроса](https://support.tulip.co/docs/how-to-set-query-parameters) читайте [здесь](https://support.tulip.co/docs/how-to-set-query-parameters)). Кроме того, вы можете указать любые входные или выходные данные, которые функции коннектора могут потребоваться для обратной связи с приложением или автоматизацией. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28463%29.png) ### Использование Postman для тестирования API Tulip Ниже описано, как создать оператор. В данном примере для создания будет использоваться [Postman](https://www.postman.com/). Сначала добавьте конечную точку API в запрос POST. ![](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» на странице API Tulip. ### Использование документации API для тестирования API Tulip В настройках вашего рабочего пространства или учётной записи перейдите в раздел «API Tulip». Оттуда перейдите к пункту «Узнать больше» рядом с опцией «Создать учётную запись службы». ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28462%29.png) Вы перейдете на страницу, где можно протестировать API с помощью созданного ключа. Там же вы найдете документацию и примеры тел запросов для различных целей. На этой странице также указан URL-адрес сервера, необходимый для настройки запросов к API из внешних систем. Чтобы ознакомиться с API, нажмите кнопку «Авторизовать». ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_205534237.png) Эта кнопка предоставит дополнительную информацию о настройке API для тестирования. Введите в поля следующие данные: - Имя пользователя: API-ключ - Пароль: секретный ключ Нажмите «Авторизовать», после чего вы сможете приступить к тестированию некоторых типичных HTTP-запросов к таблицам. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_205535341.png) Каждый из параметров на этой странице можно развернуть и протестировать. Каждый запрос предоставляет полезную информацию о соответствующих ответах. На этой странице также представлена информация о схемах для некоторых компонентов Tulip. Например, для создания записи в таблице полезно знать правильный формат JSON для каждого столбца. Пример схемы для столбцов приведен ниже: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Use%20the%20Table%20API_205536066.png)