PrestaShop 9 introduce una nueva API Admin basada en API Platform con autenticacion OAuth 2.0. Abre la puerta al comercio headless, front-ends personalizados e integraciones avanzadas con terceros.
¿Cuál es la API de Admin 9?
La nueva API de Admin es una API RESTful construida en #M14#, un marco PHP para la construcción de API modernas. Utiliza la autenticación #M27¤ 2.0, reemplazando el antiguo sistema de claves API de la API Webservice.
Diferencias clave vs Legacy Webservice API
| Característica | Legacy Webservice (PS8) | Admin API (PS9) |
|---|---|---|
| Autenticación | API Key (basic) | #M27¤ 2.0 ( credenciales de cliente) |
| Marco | XML personalizado/JSON | #M14# (standard) |
| Seguridad | Limited | Flujo moderno #M27# |
| Apoyo sin cabeza | Parcial | Total |
¿Qué puedes construir?
- #P0¤ — custom React, Vue o Next.js front-ends
- #P0¤ — aplicaciones nativas iOS/Android conectadas a tu tienda #M19#
- #P0¤ — pedidos de sincronización, productos y clientes con sistemas externos
- #P0¤ — construye herramientas de análisis e información sobre los datos de tu tienda
Cómo habilitar la API de Admin
- ¡Vamos!
- Crear un nuevo cliente de API con los alcances necesarios
- Tenga en cuenta su ID de cliente y secreto
- Usar OAuth 2.0 flujo de credenciales de clientes para obtener una ficha de acceso
- Incluir la ficha en las solicitudes de API como token Bearer
¿Todavía está disponible el servicio web de Legacy?
Sí. La API de servicio web heredada todavía funciona en PrestaShop 9 para compatibilidad atrasada. Sin embargo, la API de Admin es el enfoque recomendado para todas las nuevas integraciones.
Recursos relacionados
Ver el #M19# 9 guide para más detalles técnicos.
Conseguir una ficha de acceso - curl Ejemplo
El primer paso es crear un cliente de API en su oficina de atrás (Parámetros avanzados → Acceso API), y luego solicitar una ficha:
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
}Haciendo su primera llamada de API
Una vez que tenga el token, incluyalo como un token Bearer en sus solicitudes de 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..."Opciones de API disponibles
| Recursos | Ámbito | Métodos |
|---|---|---|
| Productos | producto read / product write | Vamos, POST, PUT, DELETE |
| Órdenes | orden read / order write | Vamos, POST, PUT |
| Clientes | cliente read / customer write | Vamos, POST, PUT, DELETE |
| Categorías | category read / category write | Vamos, POST, PUT, DELETE |
| Carritos | cart rule read / cart rule write | Vamos, POST, PUT, DELETE |
| Transportadores | port read | # |
| Criterios | cambio read | # |
Casos de uso real mundial
1. Headless Storefront
Construya una acción personalizada React o Next.js front-end que embrague productos, categorías, y maneja cart/checkout a través de la API de Admin. #M19¤ maneja la lógica del comercio; tu frontal personalizado maneja el UX.
2. Aplicación móvil
Conecta una aplicación nativa iOS o Android a tu tienda PrestaShop. La aplicación autentica con OAuth, luego lee productos, coloca pedidos y comprueba el estado de pedido a través de API, sin necesidad de raspado web.
3. ERP/CRM Integration
Órdenes de sincronización desde PrestaShop a su ERP (por ejemplo, SAP, Odoo) automáticamente. Utilice un trabajo de cron para encuestar nuevos pedidos a través de la API de Pedidos y empujarlos a su ERP. Actualizar los niveles de stock en PS desde ERP a través de la API de Productos.
4. Panel de análisis personalizado
Coloque los datos de pedido, cliente y producto en una herramienta BI personalizada (Power BI, Metabase, Grafana) para análisis más profundos que las estadísticas PrestaShop incorporadas.
Migrando desde Legacy Webservice API a Admin API
| Aspecto | Legacy Webservice | Admin API (PS9) |
|---|---|---|
| Autenticación | API Key en encabezado | #M27¤ 2.0 Token de oso |
| Caducidad | Nunca (la clave estática) | 3600 (refresco necesario) |
| Base URL | /api/products?output format=JSON | /api/products |
| Formato de respuesta | XML o JSON | JSON (JSON-LD) |
| Filtro | Query params | #M14¤ Filtros |
La API de servicio web heredada sigue siendo funcional en PS9 para la compatibilidad atrasada. Usted no necesita migrar las integraciones existentes inmediatamente, pero las nuevas integraciones deben utilizar la API de Admin.
Preguntas frecuentes
¿Está disponible la API de Admin en 8?
No. La nueva API de Admin basado en #M27¤ es exclusiva de PrestaShop 9. PrestaShop 8 utiliza la API de servicio web heredada con autenticación clave API.
¿Necesito conocimientos de codificación para usar la API?
Se requiere un conocimiento básico de REST API. Necesitas entender las solicitudes de HTTP (GET, POST, PUT, DELETE), formato de datos JSON y flujos de token OAuth 2.0. Las bibliotecas están disponibles para PHP, Python, JavaScript para simplificar esto.