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
| Caratteristica | Sito web (PS8) | Admin API (PS9) |
|---|---|---|
| Autenticazione | API Key (basic) | OAuth 2.0 |
| Quadro | XML/JSON personalizzato | API Platform (standard) |
| Sicurezza | Limitazioni | Flussi moderni OAuth |
| Supporto senza testa | Parziale | Pieno |
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
- Vai a Back Office → Parametri avanzati → Accesso API
- Creare un nuovo client API con gli ambiti richiesti
- Nota il tuo ID cliente e segreto
- Utilizzare OAuth 2.0 credenziali client flusso per ottenere un gettone di accesso
- 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
| Risorse | Ambito | Metodi |
|---|---|---|
| Prodotti | prodotto read / product write | GET, POST, PUT, DELETE |
| Ordini | ordine read / ordine write | GET, POST, PUT |
| Clienti | customer read / customer write | GET, POST, PUT, DELETE |
| Categorie | categoria read / categoria write | GET, POST, PUT, DELETE |
| Regole del carrello | cart rule read / cart rule write | GET, POST, PUT, DELETE |
| Portatori | Carrier read | G |
| Valute | valuta read | G |
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
| Aspetti | Sito web di Legacy | Admin API (PS9) |
|---|---|---|
| Autenticazione | Chiave API intestazione | OAuth 2.0 Token del cuscinetto |
| Token scadenza | Mai (chiave statica) | 3600 (rifresco necessario) |
| URL della base | /api/products?output format=JSON | /api/prodotti |
| Formato di risposta | XML o JSON | JSON (JSON-LD) |
| Filtro | Param di query | API 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.