trendyol-admin

核心用法

Trendyol Admin技能是Trendyol Marketplace API v2.0的完整知识库，专为AI Agent设计以构造正确的API请求。核心功能覆盖：

认证体系：强制Basic Auth认证（API_KEY:API_SECRET经base64编码），需配合User-Agent头部（格式为<SupplierId> - SelfIntegration）。关键特性是多国家市场切换，通过storeFrontCode参数实现，支持阿联酋(AE)、沙特(SA)、卡塔尔(QA)、科威特(KW)、巴林(BH)、阿曼(OM)、德国(DE)、阿塞拜疆(AZ)、罗马尼亚(RO)、捷克(CZ)、匈牙利(HU)、斯洛伐克(SK)、保加利亚(BG)、希腊(GR)共14个市场。

功能模块：

• 商品管理：创建、更新、删除、归档全生命周期
• 库存价格：实时库存同步与动态定价
• 订单处理：状态追踪、发货更新、物流同步
• 售后管理：退货处理与客户问题响应
• 实时通知：Webhook事件订阅

技术规范：生产环境基地址https://apigw.trendyol.com/integration/，限流50请求/10秒，图片强制1200×1800像素HTTPS链接，全JSON交互。

显著优点

• 多市场统一管理：单一API密钥管理14个欧洲国家与中东市场，大幅降低跨境运营技术门槛
• 标准化协议：RESTful设计配合完整OpenAPI规范，减少对接摩擦
• 实时同步能力：Webhook支持订单状态秒级推送，优于轮询方案
• 生态成熟度：作为土耳其最大电商平台（欧洲访问量前十），API稳定性与文档完备度经市场验证

潜在局限

• 无预封装SDK：需自行构造curl/Node.js/Python请求，增加开发成本
• 严格限流策略：50请求/10秒对大型SKU catalog批量操作可能形成瓶颈
• 图片规格刚性：1200×1800像素强制要求需预处理基础设施
• 区域合规复杂度：14国分别对应不同货币(AED/SAR/EUR等)与税务规则，需额外本地化层

适合人群

• 跨境电商ERP/OMS系统开发者
• 中东与欧洲市场多站点运营的DTC品牌技术团队
• 需要对接Trendyol的第三方SaaS服务商（库存管理、客服工具等）
• 具备基础HTTP/API开发能力的技术运营人员

常规风险

• 认证泄露风险：Basic Auth凭证需安全存储，泄露将导致全店铺权限丧失
• 限流触发：批量商品更新未做速率控制将触发429错误，影响业务连续性
• 市场代码误用：storeFrontCode参数错误会导致数据写入错误国家站点
• 图片URL失效：外部托管图片链接失效将直接导致商品下架
• 时区与货币：多国运营需自行处理夏令时与汇率波动，API层无自动转换

核心用法

本 Skill 是 Trendyol Marketplace API v2.0 的纯文档型知识库，旨在为 AI Agent 和开发者提供构建正确 API 请求所需的全部参考信息。核心使用流程包括：

1. 认证配置：采用 Basic Auth 认证模式，需使用 API_KEY 作为用户名、API_SECRET 作为密码，通过 Base64 编码生成 Authorization: Basic <token> 请求头。

2. 强制请求头：每次请求必须携带三个关键头信息：Authorization（认证令牌）、User-Agent（格式为 <SupplierId> - SelfIntegration）、以及 storeFrontCode（用于切换不同国家市场，如 AE 代表阿联酋、SA 代表沙特阿拉伯等，覆盖中东及欧洲共 14 个市场）。

3. 接口调用：Skill 本身不包含可执行代码，用户需根据 references/api_reference.md 中的端点定义，使用 curl 或 Node.js/Python 等编程语言自行实现请求。支持的功能模块涵盖商品集成（创建、更新、删除、归档）、订单处理（状态更新、物流跟踪）、库存价格管理、退货处理及客户问题应答。

4. 实时通知：文档中提供了 Webhook 配置说明，用于接收订单状态变更、库存预警等实时事件推送。

显著优点

• 多市场覆盖：单一 Skill 支持 14 个国家级市场的运营，包括阿联酋、沙特、德国、罗马尼亚等，助力卖家实现全球化布局。
• 功能完整性：覆盖电商运营的全链路场景，从商品上架到售后退货，无需切换多个工具。
• 零代码依赖：纯 Markdown 文档形式，无第三方依赖，不引入供应链攻击风险，部署轻量。
• 标准化接口：基于 RESTful 设计，统一返回 JSON 格式，便于与现代技术栈集成。
• 实时性支持：Webhook 机制确保关键业务事件的即时感知，提升运营响应速度。

潜在缺点与局限性

• 无预置执行能力：Skill 仅提供知识参考，所有 API 调用需用户自行编码实现，对非技术用户门槛较高。
• 来源可信度限制：由个人开发者 awelab 维护，属 T3 级别社区项目，API 信息可能存在滞后或与官方文档不一致的风险，需交叉验证。
• 认证信息敏感：Basic Auth 模式需明文传输编码后的密钥，存在被拦截后解码的风险，需确保 HTTPS 强制启用。
• 限流约束：50 请求/10 秒的严格限流对大规模批量操作构成挑战，需设计队列和重试机制。
• 图片规格硬性要求：1200×1800 像素的商品主图规格对部分卖家现有素材库构成改造成本。

适合的目标群体

• 跨境电商运营团队：特别是已入驻或计划入驻 Trendyol 平台，覆盖中东、欧洲多市场的卖家。
• ERP/OMS 系统集成商：需要将 Trendyol 渠道接入自研订单管理系统的技术团队。
• 多平台铺货卖家：寻求通过 API 自动化管理 Trendyol 与其他平台库存价格同步的商家。
• 数据分析开发者：需要拉取 Trendyol 交易数据进行经营分析的数据工程师。

使用风险

• 凭证泄露风险：API_KEY 和 API_SECRET 具有完整店铺操作权限，一旦泄露可导致商品信息篡改、订单恶意操作等严重后果。严禁硬编码或提交至版本控制。
• 限流触发风险：超出 50/10s 的调用频率将触发服务降级，建议实施指数退避重试策略。
• 市场代码误配风险：storeFrontCode 参数错误将导致操作指向错误国家市场，可能引发价格货币错误或库存混乱。
• 官方 API 变更风险：社区维护文档更新可能滞后于官方，建议建立与 Trendyol 开发者门户的同步校验机制。
• Webhook 端点安全风险：若配置 Webhook 接收服务，需验证请求签名防止伪造通知攻击。