Come usare le API di PrestaShop

In informatica un Web Service (servizio web) per lo standard W2C è un software progettato per l'interoperabilità tra diversi elaboratori su una medesima rete. PrestaShop ha un proprio Web Service che può essere utile per lo scambio dei dati tra PrestaShop e un altro software che può essere un gestionale, un servizio web per la sincronizzazione con il proprio negozio Ebay o Amazon, ecc...

PRESTASHOP API

La prima operazione da effettuare per poter usare il WebService è abilitarlo, per farlo dovremo andare in: Parametri avanzati -> Webservice

Creare una chiave API in PrestaShop

Clicchiamo sul + per creare un nuovo webservice

Impostare i permessi API di PrestaShop
  • Clicchiamo su "Genera!" per creare una nuova chiave per accedere al webservice
  • Inseriamo una descrizione per la chiave che stiamo creando, per ricordarci a cosa serve il webservice, per esempio: "sincronizzazione GLS" se il web service serve per collegarci al corriere.
  • Stato, permette di attivare o disabilitare la chiave in qualsiasi momento, poniamolo su SI per attivare l'accesso.
  • Permessi, qui possimo decidere quali permessi abilitare i metodi sono GET, PUT, POST, DELETE e HEAD. Nell'esempio selezioniamo tutti i permessi GET.

Fatto questo clicchiamo su "SALVA".

Abilitare il WebService di PrestaShop

Non ci rimane che attivare ora il WebService di PrestaShop attivando la voce "Attiva servizio web PrestaShop", nella maggioranza dei casi il nostro server presenta la modalità CGI per PHP, quindi attiviamo anche la voce "Abilita la modalità CGI per il PHP" e clicchiamo su SALVA

Ora possiamo interrogare il webservice di PrestaShop richiamando l'indirizzo URL così formato: http://chiave@nomedominio.ext/api/ oppure http://nomedominio.ext/api/?ws_key=chiave
Esempio: https://MNXB51PKR6LGRQWS7CNBSUI3JNBVNYSS@www.demomodule.com/api/ oppure https://www.demomodule.com/api/?ws_key=MNXB51PKR6LGRQWS7CNBSUI3JNBVNYSS

Note: possiamo anche indicare il metodo per esempio &ps_method=GET oppure il formato per esempio per JSON aggingeremo all'URL &output_format=JSON.

Se il nostro dominio è www.demomodule.com e la nostra chiave è MNXB51PKR6LGRQWS7CNBSUI3JNBVNYSS Se non inseriamo la chiave nella prima chiamata verrà richiesta dal nostro browser, in questo caso basterà indicare come Nome Utente la chiave in oggetto, senza indicare nessuna password.

Accedere alle API di PrestaShop

La chiamata restituirà i metodi disponibili:

Metodi API di PrestaShop

Portemmo così eseguire varie interrogazioni ricevendo dal WebService la risposta in formato XML, per esempio possiamo ricevere l'elenco di tutti gli ordini richiamando il seguente url: https://www.demomodule.com/api/orders.

Note: non sarà necessario passare nuovamente la chiave per interrogazioni successive.

richiamare gli ordini con le API di PrestaaShop

Richiamando URL https://www.demomodule.com/api/orders/1 avremo i dettagli dell'ordine con ID 1.

Se abbiamo abilitato il metodo DELETE potremo anche cancellare dei dati per sempio: https://www.demomodule.com/api/customers/112/?ws_key=MNXB51PKR6LGRQWS7CNBSUI3JNBVNYSS&ps_method=DELETE

Andremo a cancellare il cliente con ID numero 112.

Autore: Loris Modena

SENIOR DEVELOPER

Per Ind Loris Modena titolare di Arte e Informatica, inizia a lavorare nel settore informatico nel 1989 quale sistemista addetto alla manutenzione e installazione di sistemi informatici. Inizia a programmare per il web nel 1997 occupandosi di programmazione CGI in PERL e successivamente passando alla programmazione in PHP e JavaScript. In questo periodo si avvicina al mondo Open source e alla gestione di server Linux. 

prodotto aggiunto alla lista