--- title: "Utilizza l’API degli attributi della macchina" slug: "how-to-use-the-machine-attributes-api" updated: 2026-10-22T10:40:17Z published: 2026-10-22T10:40:17Z canonical: "support.tulip.co/how-to-use-the-machine-attributes-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. # Utilizza l’API degli attributi della macchina ## Come utilizzare l’API Machine Attributes *Crea una Tulip Machine utilizzando dati provenienti da Node-RED, Python o altri servizi.* NOTE Advanced Article - assumes previous experience with REST APIs.Click [here](https://support.tulip.co/apidocs) to view our Machines API documentation. ## Riepilogo L’API Machine Attributes consente di inviare dati a un attributo specifico di una [Machine](https://support.tulip.co/docs/intro-to-machine-monitoring) tramite un’API RESTful utilizzando l’endpoint `/attributes/report`. Ciò offre numerose opzioni flessibili per l’integrazione con Tulip da Node-RED, Python o altri linguaggi e servizi. ## Configurazione dell’API Machine Feature rename Prior to r383, Service Accounts were called "API Tokens". Nota: se disponi già di [un'API Tulip Table](https://support.tulip.co/docs/how-to-use-the-table-api) configurata, puoi utilizzare la chiave API e il segreto associati. 1. Accedi a **Impostazioni > API Tulip** 2. Fare clic su **Crea account di servizio** nell’angolo in alto a destra dello schermo 3. Assegna un nome al tuo account di servizio e seleziona **`attributes:report`** come ambito: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308117078.png) 1. Verrà visualizzata una finestra modale con la **chiave API, il codice segreto** e **l’intestazione di autenticazione**. **Si prega di salvare queste informazioni poiché non sarà più possibile accedervi!** ## Configurazione di una nuova macchina Una volta configurata l’API della macchina, apparirà una nuova fonte dati della macchina sulla tua istanza. Per visualizzare questa fonte dati, clicca su **Reparto produzione** > **Macchine** e vai alla **sezione Fonti dati delle macchine:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_299183646.png) Dovrai creare una nuova macchina collegata a questa fonte dati. Per creare una nuova macchina, vai su **Libreria macchine** e clicca su **Crea macchina.** Verrà visualizzata la seguente finestra modale: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_299184555.png) 1. *Nome macchina* (obbligatorio): assegna un nome alla tua macchina 2. *Origine dati della macchina* (obbligatorio): selezionare **Tulip API** 3. *Stazione* (facoltativo) 4. *Tipo* (obbligatorio): se non è disponibile alcun *tipo*, creane uno prima; in questo esempio il tipo creato si chiama **"default"** Ora che la macchina è stata creata, dovrai aggiungere un attributo. Fai clic su "Modifica" in alto a destra dello schermo. Quindi fai clic sul pulsante **"+"** in alto a destra dello schermo: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_457415675.png) Poiché non sono stati ancora creati attributi della macchina, fare clic sul Tipo di macchina in blu, in questo caso "Default". Verrà visualizzata la pagina relativa al tipo di macchina associato alla macchina. Fare clic sul pulsante *"Modifica"* nell’angolo in alto a destra dello schermo. Quindi premi il pulsante + accanto a "Attributi della macchina" nell’angolo in basso a sinistra. Ora clicca su ***"+ Crea attributo macchina*** " nell’angolo in basso a destra In questo esempio, creeremo un attributo **"Contatore** " di tipo **"Intero"**. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_457418550.png) Una volta creato l’attributo, fai clic sull’attributo **"Contatore"** nell’elenco degli "Attributi della macchina", quindi premi il pulsante "Salva" nell’angolo in alto a destra Torna alla pagina della tua macchina. Ora che l’attributo della macchina è stato creato, puoi aggiungerlo alla tua macchina. Premi il pulsante *Modifica* nell’angolo in alto a destra. Quindi clicca sul pulsante **+** nell’angolo in alto a destra e seleziona l’attributo **Contatore** che hai appena creato: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308127275.png) Fai clic su **"Salva** " nell'angolo in alto a destra. La tua istanza di Tulip è ora configurata con l’API della macchina, una macchina e un attributo della macchina: ora puoi inviare dati a una macchina Tulip da qualsiasi luogo! Da qui puoi visualizzare `l’attributeId` e `il machineID` dell’attributo *"Counter* ". Queste informazioni possono essere copiate cliccando sull’icona e verranno utilizzate nel corpo della richiesta HTTP. Per farlo, è necessario avere familiarità con le API REST. La documentazione completa su come utilizzare l’endpoint `/attributes/report`, inclusi i parametri di query e il formato del corpo della richiesta, è disponibile all’indirizzo *your-company.tulip.co/apidocs* oppure seguendo il link nella pagina *delle API di Tulip*... ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308124025.png) ... e nella documentazione è presente una sezione dedicata al monitoraggio delle macchine ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20use%20the%20Machine%20Attributes%20API_308122257.png) ## Approfondimenti [Dai un'occhiata a questo articolo](https://support.tulip.co/docs/using-node-red-with-edge-mc) se vuoi approfondire l'API e scoprire come può essere utilizzata con Edge MC e Node-RED!