MENU
    머신 속성 API 사용 방법
    • 08 Jan 2025
    • 2 읽을 분
    • 기여자

    머신 속성 API 사용 방법


    기사 요약

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

    Node-RED, Python 또는 기타 서비스의 데이터를 사용하여 튤립 머신을 생성하세요.

    NOTE

    Advanced Article - assumes previous experience with REST APIs.Click here to view our Machines API documentation.

    요약

    머신 속성 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에서 어떻게 사용할 수 있는지 알아보려면이 문서를 확인하세요!


    이 문서가 도움이 되었습니까?