--- title: "운영자 API 가이드" slug: "using-the-operator-api" tags: ["Operator", "Operator API", "API"] updated: 2026-10-22T14:34:51Z published: 2026-10-22T14:34:51Z 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 가이드 *Operator API 설정 방법 알아보기* Advanced Content This article assumes previous experience with APIs. Tulip에서 개발된 앱을 실행할 사용자를 등록하려면 사이트에 운영자를 추가해야 합니다. 운영자는 다음 두 가지 방법으로 생성할 수 있습니다:* **설정** 메뉴에 있는 [‘사용자’ 페이지*](https://support.tulip.co/docs/adding-users-and-managing-user-roles) Tulip API를 통해 외부 시스템을 활용. 아래 절차는 Tulip API를 사용하여 운영자를 생성하는 방법을 보여줍니다. ## 운영자 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) **'Tulip API'를** 선택한 다음, 오른쪽 상단의 **'서비스 계정 생성'** 버튼을 클릭합니다. ![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**. ## Operator API 사용 다음에서는 오퍼레이터를 생성하는 방법을 단계별로 설명합니다. 이 예제에서는 [Postman을](https://www.postman.com/) 사용하여 생성 작업을 수행합니다. 먼저, Post 요청에 API 엔드포인트를 추가합니다. 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) 그런 다음, ‘Authorization’에서 **‘Basic Auth’를** 선택하고, **‘Username**’에 API 키를, **‘Password**’에 API 시크릿을 입력합니다. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) '헤더(Headers)' 섹션에서 **'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) 요청이 실패한 경우, 키(Key)와 시크릿(Secret)이 올바른지 확인하십시오. 특정 응답 코드에 대한 자세한 내용은 ['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.