Admin API PrestaShop 9: Commercio Headless e Guida all'Integrazione

PrestaShop 9 introduce una nuova Admin API basata su API Platform con autenticazione OAuth 2.0. Apre le porte al commercio headless, front-end personalizzati e integrazioni avanzate con terze parti.

Qual è l'API PrestaShop 9 Admin?

La nuova API Admin è una API RESTful costruita su #, un framework PHP per la costruzione di API moderne. Utilizza l'autenticazione # M27 # 2.0 #, sostituendo il vecchio sistema chiave API dall'API di Webservice.

Differenze chiave vs Legacy Webservice API

CaratteristicaSito web (PS8)Admin API (PS9)
AutenticazioneAPI Key (basic)OAuth 2.0
QuadroXML/JSON personalizzatoAPI Platform (standard)
SicurezzaLimitazioniFlussi moderni OAuth
Supporto senza testaParzialePieno

Cosa puoi costruire?

  • Negozi senza testa — React personalizzato, Vue o Next.js front-end
  • Applicazioni mobili — applicazioni native iOS / Android collegate al tuo negozio PrestaShop
  • Integrazioni ERP/CRM — sincronizzare ordini, prodotti e clienti con sistemi esterni
  • Cruscotti personalizzati — costruire strumenti di analisi e reporting in cima ai dati del tuo negozio

Come Attivare l'API Admin

  1. Vai a Back Office → Parametri avanzati → Accesso API
  2. Creare un nuovo client API con gli ambiti richiesti
  3. Nota il tuo ID cliente e segreto
  4. Utilizzare OAuth 2.0 credenziali client flusso per ottenere un gettone di accesso
  5. Includere il token nelle richieste API come token Bearer

Il Webservice Legacy è ancora disponibile?

Si'. L'API di Webservice legacy funziona ancora in PrestaShop 9 per la compatibilità retromarcia. Tuttavia, l'API Admin è l'approccio raccomandato per tutte le nuove integrazioni.

Risorse correlate

Vedere il pieno PrestaShop 9 guida per maggiori dettagli tecnici.

Ottenere un Token di Accesso — Curl Esempio

Il primo passo è quello di creare un client API nel tuo back office (Parametri avanzati → Accesso API), quindi richiedere un token:

curl -X POST "https://yourstore.com/oauth2/token" 
  -H "Content-Type: application/x-www-form-urlencoded" 
  -d "grant_type=client_credentials" 
  -d "client_id=your_client_id" 
  -d "client_secret=your_client_secret"

# Response:
{
  "access_token": "eyJ0eXAiOiJKV1Q...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Rendere la vostra prima chiamata API

Una volta che avete il token, includerlo come un token Bearer nelle vostre richieste API:

# List products
curl -X GET "https://yourstore.com/api/products" 
  -H "Authorization: Bearer eyJ0eXAiOiJKV1Q..."

# Get a single order
curl -X GET "https://yourstore.com/api/orders/12345" 
  -H "Authorization: Bearer eyJ0eXAiOiJKV1Q..."

Scopi e risorse API disponibili

RisorseAmbitoMetodi
Prodottiprodotto read / product writeGET, POST, PUT, DELETE
Ordiniordine read / ordine writeGET, POST, PUT
Clienticustomer read / customer writeGET, POST, PUT, DELETE
Categoriecategoria read / categoria writeGET, POST, PUT, DELETE
Regole del carrellocart rule read / cart rule writeGET, POST, PUT, DELETE
PortatoriCarrier readG
Valutevaluta readG

Casi di utilizzo reali

1. Fronte negozio senza testa

Costruire un React personalizzato o Next.js front-end che fetches prodotti, categorie e gestisce carrello / checkout tramite l'API Admin. PrestaShop gestisce la logica del commercio; il tuo front-end personalizzato gestisce l'UX.

2. Mobile App

Collegare un'applicazione nativa iOS o Android al tuo negozio PrestaShop. L'applicazione autentica con OAuth, quindi legge i prodotti, posiziona gli ordini e controlla lo stato dell'ordine tramite API - nessun raschio web richiesto.

3. Integrazione ERP/CRM

Sincronizza gli ordini da PrestaShop al tuo ERP (ad esempio, SAP, Odoo) automaticamente. Utilizzare un lavoro cron per sondare nuovi ordini tramite l'API Ordini e spingerli al tuo ERP. Aggiorna i livelli di stock in PS da ERP tramite l'API dei Prodotti.

4. Dashboard analitico personalizzato

Estrarre i dati dell'ordine, del cliente e del prodotto in uno strumento BI personalizzato (Power BI, Metabase, Grafana) per analisi più profonde rispetto alle statistiche integrate PrestaShop.

Migrazione da Legacy Webservice API a Admin API

AspettiSito web di LegacyAdmin API (PS9)
AutenticazioneChiave API intestazioneOAuth 2.0 Token del cuscinetto
Token scadenzaMai (chiave statica)3600 (rifresco necessario)
URL della base/api/products?output format=JSON/api/prodotti
Formato di rispostaXML o JSONJSON (JSON-LD)
FiltroParam di queryAPI Platform Filtri

L'API di Webservice legacy rimane funzionale in PS9 per la compatibilità retromarcia. Non è necessario migrare immediatamente le integrazioni esistenti, ma nuove integrazioni dovrebbero utilizzare l'API Admin.

Domande frequenti

L'API Admin è disponibile in PrestaShop 8?

No. La nuova API Admin basata su OAuth è esclusiva di PrestaShop 9. PrestaShop 8 utilizza l'API di Webservice legacy con l'autenticazione chiave API.

Ho bisogno di codificare le conoscenze per utilizzare l'API?

La conoscenza base delle API REST è necessaria. È necessario comprendere le richieste HTTP (GET, POST, PUT, DELETE), il formato di dati JSON e i flussi di token OAuth 2.0. Le biblioteche sono disponibili per PHP, Python, JavaScript per semplificare questo.


PrestaSOO team
Tutto il necessario per guadagnarti da vivere facendo il lavoro che ami.

Scoprire


È un investimento saggio

I moduli Prestashop che abbiamo creato per primi per risolvere il problema del nostro business - un sito di e-commerce. Ciò significa che sono molto utili per un'azienda seria. Se apprezzi la tua proprietà web, questi moduli sono un investimento saggio.
Sarah Reeves, Sviluppatore di app @ PrestaSOO
Realizzato con a Parigi e Hanoi
PrestaSOO © 2026. Tutti i diritti riservati. // Politica sulla riservatezza Termini di servizio