用途:该技能解答 PrestaShop(开源、自托管 PHP/MySQL 电商平台)相关问题,包括开店、Webservice API 集成、商品/订单/库存同步、订单事件推送、模块/覆写/升级排障与平台选型判断。
主要能力与用法:核心是 /api/ 的 CRUD Webservice,默认 XML;需在后台 Advanced Parameters → Web service 启用,创建 32 字符 key 并按资源授权;认证用 HTTP Basic,key 作用户名、密码为空(curl -u "KEY:")。加 output_format=JSON 返回 JSON;GET /api/ 列出可访问资源。读取支持 display=[…]、filter[field]=…(OR [a|b]、区间 [min,max]、%pattern%)、sort=[field_ASC]、limit=start,count 偏移分页(无游标)。创建用 ?schema=blank;PUT 为整体替换,需 GET 完整记录后修改再写回并保留 <id>,仅 stock_availables、warehouses 等支持 PATCH;库存数量在 stock_availables,不在 products。
事件推送:内核无原生出站 Webhook。可通过编写模块注册钩子(actionValidateOrder、actionOrderStatusUpdate)并 cURL 外发(自行加 HMAC),或使用第三方 Webhooks 模块,或轮询订单;钩子在结账进程内执行,需保持快速。
适用场景与限制:属于自托管,基础设施与升级由用户负责,需匹配 PHP 与 PrestaShop 版本,保持覆写精简,主版本升级前在 staging 测试 1-Click Upgrade。它不是 Merchant of Record,税务自负。Advanced Stock Management 可选,仅在启用时存在 warehouses/supply_orders/stock_movements 资源。跨平台策略类问题应转交相应技能。资料注明为 2026-07 基于研究的最佳努力,资源列表、动词、认证行为、定价与 PHP/版本兼容性需对照实时文档复核。