--- title: "オペレーターAPIガイド" slug: "using-the-operator-api" updated: 2026-10-22T14:34:08Z published: 2026-10-22T14:34:08Z 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で開発されたアプリを実行するユーザーを設定するには、サイトにオペレーターを追加する必要があります。オペレーターの作成方法は2つあります:***「設定」**にある[「ユーザー」ページ*](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**」を選択し、**ユーザー名**にAPIキー、**パスワード**にAPIシークレットを入力します。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) 「Headers」セクションで、「**Auth Header**」を追加します。 ![](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.