머신 속성 API 사용 방법

머신 속성 API를 사용하는 방법

Node-RED, Python 또는 기타 서비스의 데이터를 사용하여 튤립 머신을 만듭니다.

:::(Info) (참고) 고급 문서 - REST API에 대한 이전 경험이 있다고 가정합니다. 여기를 클릭하여 머신 API 설명서를 확인하세요:::

요약

머신 속성 API를 사용하면 /attributes/report 엔드포인트를 사용하여 RESTful API를 통해 머신의 특정 속성으로 데이터를 전송할 수 있습니다. 이를 통해 Node-RED, Python 또는 기타 언어 및 서비스에서 Tulip과 통합할 수 있는 여러 가지 유연한 옵션을 사용할 수 있습니다.

머신 API 설정하기

참고: 이미 설정된 Tulip 테이블 API가 있는 경우 해당 API 키와 시크릿을 사용할 수 있습니다.

1. 설정 > API 토큰으로 이동합니다.
2. 화면 오른쪽 상단에서 API 토큰 만들기를 클릭합니다.
3. API 토큰의 이름을 지정하고 해당 토큰의 범위에 대해 속성:쓰기를 선택합니다:

{높이="" 너비=""}

1. API 키, 비밀번호 및 인증 헤더가 포함된 모달이 나타납니다. 이 정보는 다시 액세스할 수 없으므로 저장해 두세요!

축하합니다 - 공식적으로 머신 API를 설정하셨습니다!

새 머신 설정하기

머신 API를 설정하면 인스턴스에 새 머신 데이터 소스가 나타납니다. 이 데이터 소스를 보려면 작업 현장 > 머신을 클릭하고 머신 데이터 소스로 이동합니다 :

{height="" width=""}로 이동합니다.

이 데이터 소스에 연결된 새 머신을 만들어야 합니다. 새 머신을 생성하려면 머신 라이브러리로 이동한 다음 머신 생성을 클릭합니다 .

다음 모달이 나타납니다:

1. 머신 이름 (필수): 머신의 이름을 지정합니다.
2. 머신 데이터 소스 (필수): 튤립 API 선택
3. 스테이션 (선택 사항)
4. 유형 (필수): 사용할 수 있는 유형이 없는 경우 먼저 유형을 만듭니다. 이 예제에서는 생성된 유형의 이름이 기본입니다.

이제 머신이 생성되었으므로 속성을 추가해야 합니다. 화면 오른쪽 상단의 수정을 클릭합니다. 그런 다음 화면 오른쪽 상단의 + 버튼을 클릭합니다:

아직 머신 속성이 생성되지 않았으므로 파란색의 머신 유형(이 경우 기본값)을 누릅니다.

그러면 머신과 연결된 머신 유형으로 이동합니다. 화면 오른쪽 상단의 편집 버튼을 누릅니다.

그런 다음 왼쪽 하단의 머신 속성 옆에 있는 + 버튼을 누릅니다.

이제 오른쪽 아래 모서리에 있는 + 머신 속성 만들기 버튼을 누릅니다.

이 예제에서는 정수 유형의 카운터 속성을 만들겠습니다.

속성이 생성되면 머신 속성 목록에서 카운터 속성을 클릭한 다음 오른쪽 상단 모서리에 있는 저장을 누릅니다.

머신 페이지로 돌아갑니다.

이제 머신 어트리뷰트가 생성되었으므로 머신에 추가할 수 있습니다. 오른쪽 상단의 편집 버튼을 누릅니다. 그런 다음 오른쪽 상단의 + 버튼을 클릭하고 방금 만든 카운터 속성을 선택합니다:

오른쪽 상단의 저장을 클릭합니다.

이제 튤립 인스턴스가 머신 API, 머신, 머신 어트리뷰트로 설정되었으므로 이제 어디서나 데이터를 튤립 머신으로 전송할 수 있습니다!

여기에서 카운터 속성에 대한 attributeId와 machineID를 볼 수 있습니다. 이 정보는 아이콘을 클릭하여 복사할 수 있으며 http 요청 본문에 사용됩니다.

이렇게 하려면 REST API에 익숙해야 합니다. 쿼리 매개변수 및 본문 형식을 포함하여 /attributes/report 엔드포인트 사용 방법에 대한 전체 문서는 your-company.tulip.co/apidocs 또는 API 토큰 페이지의 링크를 따라가면 확인할 수 있습니다...

... 그리고 문서에는 머신 모니터링 섹션이 있습니다.

추가 읽기

API를 더 자세히 살펴보고 Edge MC 및 Node-RED에서 어떻게 사용할 수 있는지 알아보려면이 문서를 확인하세요!