# API REST di WooCommerce: come funziona

L’API REST di WooCommerce permette di accedere al pannello gestionale del vostro negozio WooCommerce da remoto (ma non solo). Le operazioni elementari come “Lettura” o “Scrittura” vengono **gestite tramite richieste HTTP**. Potete attivare l’API di WooCommerce direttamente dal back end.

## Che cos’è un’API REST?

In un’[API](https://www.ionos.it/digitalguide/siti-web/programmazione-del-sito-web/che-cose-unapi/ "Che cos’è un’API?") REST vengono definite le risorse di un sistema, con le quali si interagisce attraverso l’[architettura REST](https://www.ionos.it/digitalguide/server/know-how/rest-la-soluzione-http-per-servizi-web/ "REST: la soluzione HTTP per servizi web") (**Re**presentational **S**tate **T**ransfers). Un’interfaccia di questo tipo rappresenta una delle migliori soluzioni per consentire ai sistemi per il web una facile ed efficiente comunicazione tra client e server.

A ogni risorsa vengono assegnati dei parametri utili a descriverla e che possono anche essere modificati. Le architetture REST sono realizzate utilizzando il **protocollo http**, all’interno del quale ogni risorsa può essere identificata attraverso un **URI univoco** (Uniform Resource Identifier). I parametri vengono fissati come parametri URL e la gestione delle risorse avviene attraverso azioni HTTP standard come GET, POST, PUT e DELETE.

## A cosa serve un’API REST in WooCommerce?

La caratteristica più importante di un’API in WooCommerce per gli accessi REST è la sua universalità. Infatti, l’API è stata sviluppata in maniera tale da consentire una facile interazione in rete dei negozi WooCommerce con altri siti web o servizi. Di questa **versatile interattività** con altre applicazioni web ne beneficiano non soltanto gli sviluppatori ma anche tutti gli utenti della piattaforma WooCommerce, come dimostrano i seguenti esempi relativi ai **vantaggi di utilizzo dell’API di WooCommerce**:

- **Accesso multipiattaforma**: si può accedere da applicazioni terze direttamente alla dashboard di WooCommerce? Con l’API REST sì e in maniera molto facile.
- **Integrazione facile della logica di business**: i software e gli hardware specifici per il business come i wearable o i dispostivi di localizzazione dell’IoT possono essere integrati nel progetto semplicemente grazie all’API REST di WooCommerce.
- **Ottimizzazione della sincronizzazione dati**: le imprese che vogliono sincronizzare il negozio WooCommerce con i dati di diverse piattaforme e canali, trovano nell’API REST l’interfaccia giusta per farlo.
- **Indipendenza dal back end di WooCommerce**: con l’attivazione dell’API universale di WooCommerce vi rendete indipendenti dal back end di WooCommerce e di WordPress. Potete integrare e iniziare a usare la vostra interfaccia gestionale in qualsiasi momento.
- **Integrazione semplice dei dati di fornitori terzi**: con l’interfaccia REST avete comodamente accesso ai dati delle applicazioni di fornitori terzi.
- **Collegamento con app mobile**: collegare il vostro negozio WooCommerce con un’app mobile diventa significativamente più semplice grazie a questa versatile interfaccia.

Consiglio Siete alla ricerca di un ambiente hardware adatto alle vostre esigenze per il vostro negozio? L’[Hosting WooCommerce](https://www.ionos.it/soluzioni-ecommerce/hosting-woocommerce "Hosting per WooCommerce di IONOS") di IONOS vi offre una base sicura e affidabile per realizzare il vostro progetto e-commerce a un prezzo conveniente!

## Guida all’utilizzo dell’API REST di WooCommerce

Se volete usare l’API di WooCommerce per l’interazione con altre applicazioni web e servizi dovete per prima cosa attivarla generando una chiave API. Dopodiché dovete installare un client per l’accesso REST. Qui di seguito abbiamo riassunto per voi i singoli passaggi da eseguire.

### Primo passaggio: generare la chiave per l’API REST di WooCommerce

Per poter usare l’API REST di WooCommerce, la prima cosa da fare è generare una chiave API. Questa chiave rappresenta una sorta di controllo degli accessi e sarà successivamente utilizzata da WooCommerce per **autenticare le richieste REST**.

Per generare una chiave dovete:

1. Accedere al back end di WooCommerce (WordPress).
2. Aprire la scheda “**WooCommerce**” nel menu laterale di sinistra.
3. Cliccare su “**Impostazioni**”.
4. Passare alla scheda “**Avanzato**”.
5. Selezionare la sezione “**API REST**”.
6. Cliccare su “**Aggiungi chiave**” o “**Crea una chiave API**”.

[![Immagine: Il menu dell’API REST nel back end di WooCommerce](https://www.ionos.it/digitalguide/fileadmin/_processed_/c/7/csm_woocommerce-rest-api-menu-backend_3c705105c0.webp "Il menu dell’API REST nel back end di WooCommerce")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-menu-backend.jpg) Il menu dell’API REST nel back end di WooCommerce. Dovete impostare tre caratteristiche per la chiave: nel campo **“Descrizione”** riportate una breve spiegazione utile a riconoscere la chiave. Nel campo **“Utente”** selezionate l’utente WooCommerce per il quale state generando l’accesso all’interfaccia. Nel campo **“Permessi”** stabilite se l’utente ha soltanto uno tra i permessi di lettura e scrittura o se, invece, gli vengono assegnati entrambi.

Una volta fatto, confermate il tutto con un clic su **“Genera chiave API”**. WooCommerce crea due sequenze di caratteri alfanumerici (**Chiave utente e Utente nascosto**) e un codice QR. Copiate entrambe le chiavi e salvatele in un documento. Ne avrete bisogno più tardi, quando vorrete accedere all’API WooCommerce con un client REST.

[![Immagine: WooCommerce: chiave utente, utente nascosto e codice QR](https://www.ionos.it/digitalguide/fileadmin/_processed_/6/9/csm_woocommerce-rest-api-consumer-key-secrect-qr-code_074959f0d2.webp "WooCommerce: chiave utente, utente nascosto e codice QR")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-consumer-key-secrect-qr-code.jpg) WooCommerce: chiave utente, utente nascosto e codice QR. ### Secondo passaggio: scaricare il client API

Non appena avete generato la chiave, potete inviare le vostre richieste all’interfaccia del sistema WooCommerce. Il requisito per farlo è un client API con il quale effettuare la richiesta e visualizzare la risposta.

Tra i client più comuni per l’accesso REST troviamo [Insomnia](https://insomnia.rest/download "Pagina di download del client API Insomnia") e [Postman](https://www.postman.com/ "Sito web del client API Postman"). Entrambi gli strumenti sono disponibili come applicazione desktop per Windows, macOS e Linux. Postman, che abbiamo utilizzato per questa guida, è anche utilizzabile come applicazione web direttamente dal browser.

Per installare e configurare Postman dovete:

1. Aprire la [pagina di download di Postman](https://www.postman.com/downloads/ "Pagina di download del client API Postman") e caricare la versione adatta al vostro sistema operativo.
2. Eseguire il file di setup di Postman con un doppio clic.
3. Creare un account Postman, fornendo un indirizzo e-mail valido, un nome utente e una password. In alternativa, potete registrarvi con un account Google.
4. Fornire le informazioni che vi vengono richieste e condividere il link d’invito ai vostri colleghi (se ne avete bisogno).

[![Immagine: Screenshot del client di Postman](https://www.ionos.it/digitalguide/fileadmin/_processed_/3/7/csm_woocommerce-rest-api-postman-client_d71be02730.webp "Screenshot del client di Postman")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-postman-client.jpg) Screenshot del client di Postman.  Consiglio Non avete ancora un indirizzo web adatto per il vostro progetto con WooCommerce? Registrate oggi stesso il vostro [dominio](https://www.ionos.it/dominio/registra-dominio "Registrazione domini - IONOS") personalizzato con IONOS e beneficiate, tra l’altro, di un certificato SSL/TLS gratuito e del blocco del dominio per il vostro negozio WooCommerce!

### Terzo passaggio: inviare una richiesta all’API di WooCommerce

Dopo la configurazione potete verificare l’accesso all’API REST inviando una prima richiesta. Per farlo, aprite il vostro spazio di lavoro e cliccate su “**Create new request**”.

[![Immagine: Creare nuove richieste in Postman](https://www.ionos.it/digitalguide/fileadmin/_processed_/d/6/csm_woocommerce-rest-api-new-requests_bc8d349580.webp "Creare nuove richieste in Postman")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-new-requests.jpg) Client Postman: create una nuova richiesta API nel vostro spazio di lavoro con il pulsante “Create new request”. Per effettuare una prima prova scegliamo una **richiesta GET** che ci serve a ricevere dei dati. Questa opzione è impostata in automatico in Postman. Nel campo relativo all’indirizzo digitate il seguente indirizzo dopo “GET”:

```none
https://woocommerce-domain.xyz/wp-json/wc/v3/orders
```

N.B. Invece di *woocommerce-domain.xyz* dovete utilizzare l’**indirizzo** del vostro negozio WooCommerce.

Infine, aggiungete i dati per l’autenticazione dell’API REST di WooCommerce. Qui bisogna specificare se l’accesso REST avviene tramite HTTP o HTTPS (raccomandato). Spostate il cursore **“Authorization”** e, nel campo **“Type”**, selezionate “OAuth 1.0” per HTTP o “Basic Auth” per HTTPS. Dopodiché digitate i codici salvati per chiave utente e utente nascosto. Nel caso di Basic Auth, la chiave deve essere inserita nel campo “Username” e la chiave dell’utente nascosto nel campo “Password”.

[![Immagine: Alt-Text: Screenshot di Postman: inserimento della chiave utente e dell’utente nascosto dell’API](https://www.ionos.it/digitalguide/fileadmin/_processed_/5/f/csm_woocommerce-rest-api-authorization-using-https_65983ba609.webp "Alt-Text: Screenshot di Postman: inserimento della chiave utente e dell’utente nascosto dell’API")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-authorization-using-https.jpg) Screenshot di Postman: inserimento della chiave utente e dell’utente nascosto dell’API. Non appena avete terminato la configurazione dell’autenticazione, cliccate sul pulsante **“Send”** per inviare la richiesta. Con l’indirizzo di esempio da noi utilizzato, la richiesta GET serve a ottenere tutti gli ordini in corso. Il **risultato viene mostrato da Postman nella finestra sottostante** nel formato che preferite tra JSON, XML, HTML o testuale.

[![Immagine: Postman: risultato della richiesta GET per gli ordini in corso](https://www.ionos.it/digitalguide/fileadmin/_processed_/0/5/csm_woocommerce-rest-api-response-get-request_49aa2f3530.webp "Postman: risultato della richiesta GET per gli ordini in corso")](https://www.ionos.it/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-response-get-request.jpg) Postman: risultato della richiesta GET per gli ordini in corso.  Consiglio Nella Digital Guide trovate molti articoli interessanti dedicati a WordPress e WooCommerce:

- [REST API di WordPress](https://www.ionos.it/digitalguide/hosting/blog/rest-api-di-wordpress/ " REST API di WordPress")
- [Temi WooCommerce](https://www.ionos.it/digitalguide/hosting/cms/temi-woocommerce/ "Temi WooCommerce")
- [Pagamenti su WooCommerce](https://www.ionos.it/digitalguide/hosting/cms/pagamenti-su-woocommerce/ "Pagamenti su WooCommerce")
- [Plugin per WooCommerce](https://www.ionos.it/digitalguide/hosting/cms/plugin-per-woocommerce/ "Plugin per Woocommerce")
- [Shortcode di WooCommerce](https://www.ionos.it/digitalguide/hosting/cms/shortcode-di-woocommerce/ "Shortcode di WooCommerce")


This is a markdown version of: [https://www.ionos.it/digitalguide/hosting/cms/api-rest-woocommerce/](https://www.ionos.it/digitalguide/hosting/cms/api-rest-woocommerce/) for AI/LLM consumption.