Operator API 설정 방법 알아보기
This article assumes previous experience with APIs.
Tulip에서 개발된 앱을 실행할 사용자를 등록하려면 사이트에 운영자를 추가해야 합니다. 운영자는 다음 두 가지 방법으로 생성할 수 있습니다:* 설정 메뉴에 있는 ‘사용자’ 페이지* Tulip API를 통해 외부 시스템을 활용.
아래 절차는 Tulip API를 사용하여 운영자를 생성하는 방법을 보여줍니다.
운영자 API 토큰 추가
Prior to r383, Service Accounts were called "API Tokens".
Tulip 인스턴스에서 오른쪽 상단 모서리의 프로필 아이콘을 클릭하고 ‘설정’을 선택합니다.
'Tulip API'를 선택한 다음, 오른쪽 상단의 '서비스 계정 생성' 버튼을 클릭합니다.
'생성' 메뉴에서 API 토큰의 이름을 지정하고 'users:write' 범위를 선택합니다. '생성'을 클릭합니다.
Make sure to save the Service Account information for the API Key, Secret, and Authorization Header.
Operator API 사용
다음에서는 오퍼레이터를 생성하는 방법을 단계별로 설명합니다. 이 예제에서는 Postman을 사용하여 생성 작업을 수행합니다.
먼저, Post 요청에 API 엔드포인트를 추가합니다.
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
그런 다음, ‘Authorization’에서 ‘Basic Auth’를 선택하고, ‘Username’에 API 키를, ‘Password’에 API 시크릿을 입력합니다.
'헤더(Headers)' 섹션에서 'Auth' 헤더를 추가합니다.
본문(Body)에서 JSON 객체를 포함하도록 요청을 구성하십시오. 이 요청의 일반적인 형식은 다음과 같습니다.
{"role": "operator","name": "string","badge_id": "string"}
그러면 다음과 같은 모양이 됩니다:
'보내기'를 클릭하여 요청을 실행하면, 성공을 나타내는 201 응답을 받게 됩니다. 확인을 위해 **'설정'**에서 사용자 목록을 확인하여 사용자가 성공적으로 생성되었는지 확인할 수 있습니다.
요청이 실패한 경우, 키(Key)와 시크릿(Secret)이 올바른지 확인하십시오. 특정 응답 코드에 대한 자세한 내용은 'API 소개'를 참조하십시오.
원하시는 정보를 찾으셨나요?
community.tulip.co로 이동하여 질문을 게시하거나 다른 사용자들이 비슷한 문제를 겪은 적이 있는지 확인해 보세요!