--- title: "머신 속성 API 사용" slug: "how-to-use-the-machine-attributes-api-1" tags: ["API", "Machine Monitoring", "Machine Attribute", "Node-RED"] updated: 2026-10-22T10:40:36Z published: 2026-10-22T10:40:36Z canonical: "support.tulip.co/how-to-use-the-machine-attributes-api-1" --- > ## 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 사용 ## Machine Attributes API 사용 방법 *Node-RED, Python 또는 기타 서비스의 데이터를 사용하여 Tulip 머신을 생성합니다.* NOTE Advanced Article - assumes previous experience with REST APIs.Click [here](https://support.tulip.co/apidocs) to view our Machines API documentation. ## 요약 Machine Attributes API를 사용하면 `/attributes/report` 엔드포인트를 통해 RESTful API 방식으로 [머신의](https://support.tulip.co/docs/intro-to-machine-monitoring) 특정 속성에 데이터를 전송할 수 있습니다. 이를 통해 Node-RED, Python 또는 기타 언어 및 서비스에서 Tulip과 유연하게 통합할 수 있는 다양한 옵션이 제공됩니다. ## Machine API 설정 Feature rename Prior to r383, Service Accounts were called "API Tokens". 참고: 이미 [Tulip 테이블 API가](https://support.tulip.co/docs/how-to-use-the-table-api) 설정되어 있는 경우, 해당 API 키와 시크릿을 사용할 수 있습니다. 1. **설정 > Tulip API**로 이동합니다. 2. 화면 우측 상단의 **‘서비스 계정 생성’을** 클릭합니다. 3. 서비스 계정 이름을 지정하고, 범위(scope)로 **`attributes:report를`** 선택하세요: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308117078.png) 1. **API 키, 시크릿** 및 **인증 헤더가** 포함된 모달 창이 나타납니다. **이 정보는 나중에 다시 확인할 수 없으므로 반드시 저장해 두십시오!** ## 새 기계 설정 머신 API를 설정하면 인스턴스에 새로운 머신 데이터 소스가 나타납니다. 이 데이터 소스를 보려면 **[Shop Floor** ] > [ **Machines**]를 클릭한 후 [ **Machine Data Sources]**로 이동하십시오 **:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_299183646.png) 이 데이터 소스에 연결된 새 머신을 생성해야 합니다. 새 머신을 생성하려면 **‘머신** 라이브러리’로 이동하여 **‘머신 생성’을** 클릭하십시오 **.** 다음과 같은 모달 창이 나타납니다: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_299184555.png) 1. *기계 이름* (필수): 기계 이름을 입력하세요 2. *머신 데이터 소스* (필수): **Tulip API를** 선택하세요 3. *스테이션* (선택 사항) 4. *유형* (필수): 사용할 *유형이* 없는 경우 먼저 유형을 생성하십시오. 이 예시에서는 **'default'라는** 이름의 유형이 생성되었습니다. 머신이 생성되었으므로 이제 속성을 추가해야 합니다. 화면 오른쪽 상단의 ‘편집’을 클릭하세요. 그런 다음 화면 오른쪽 상단의 **‘+’** 버튼을 클릭하세요: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_457415675.png) 아직 머신 속성이 생성되지 않았으므로 파란색으로 표시된 머신 유형(이 예에서는 'Default')을 클릭하십시오. 그러면 해당 머신과 연결된 머신 유형 페이지로 이동합니다. 화면 오른쪽 상단의 *‘편집’* 버튼을 누르세요. 그런 다음 화면 왼쪽 하단의 ‘머신 속성’ 옆에 있는 ‘+’ 버튼을 누르세요. 이제 화면 오른쪽 하단에 있는 ***‘+ 기계 속성 생성’을*** 클릭하세요. 이 예시에서는 **정수(Integer**) 유형의 **카운터** (Counter) 속성을 생성해 보겠습니다. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_457418550.png) 속성이 생성되면 ‘머신 속성’ 목록에서 **‘카운터** 속성’을 클릭한 다음, 화면 오른쪽 상단의 ‘저장’을 누르십시오. 기계 페이지로 돌아가세요. 이제 머신 속성이 생성되었으므로, 이를 머신에 추가할 수 있습니다. 오른쪽 상단 모서리에 있는 *‘편집’* 버튼을 누르세요. 그런 다음 오른쪽 상단 모서리에 있는 **‘+’** 버튼을 클릭하고 방금 생성한 **카운터** 속성을 선택하세요: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308127275.png) 오른쪽 상단의 **‘저장’을** 클릭해 주세요. 이제 Tulip 인스턴스에 Machine API, 머신 및 머신 속성이 설정되었습니다. 이제 어디서든 Tulip 머신으로 데이터를 전송할 수 있습니다! 여기에서 *카운터* 속성의 `attributeId와` `machineID를` 확인할 수 있습니다. 이 정보는 아이콘을 클릭하여 복사할 수 있으며, HTTP 요청 본문에 사용됩니다. 이를 수행하려면 REST API에 대해 잘 알고 있어야 합니다. 쿼리 매개변수 및 본문 형식을 포함하여 `/attributes/report` 엔드포인트 사용 방법에 대한 전체 문서는 *your-company.tulip.co/apidocs에서* 확인하거나 *Tulip API* 페이지의 링크를 따라가면 볼 수 있습니다... ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308124025.png) ... 또한 문서에는 ‘Machine Monitoring’ 섹션이 있습니다. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308122257.png) ## 추가 자료 API를 더 깊이 활용하고 Edge MC 및 Node-RED와 함께 사용하는 방법을 알고 싶다면[이 기사를 확인해 보세요](https://support.tulip.co/docs/using-node-red-with-edge-mc)!