核心用法
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层无自动转换