Shopee 自用 API 开通向导
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范 @org-zfj6zggg/ecom-auto-api-shopee。
技能介绍
要解决的问题
给自家 Shopee 店铺接自动化时,这一步的卡点往往不在写代码,而在账号类型选错、签名对不上、环境搞混。如果一开始按第三方平台(ISV)提交,后面想改成自用入口非常麻烦;也可能 sign 一直报错,却找不到原因——只是把沙箱 key 发到了生产 host。
技能如何工作
这份 skill 只聚焦一件事:用 Seller In House 路径为自有店铺开通 Shopee Open Platform,拿到后续自动化可用的数据入口。
- 先锁定 Account Type + App Type:自用选 Individual Seller / Registered Business Seller,勿选 Third-party Partner Platform
- 按申请前清单逐步准备资料,走官方开放平台提交
- 对齐签名机制:每请求
HMAC-SHA256,确认path、timestamp与当前环境 key 一致 - 区分两套凭证:Test Partner ID/Key 只配 sandbox host;Live Partner ID/Key 才配生产 host
- 处理回调与续期:授权 timestamp 短时有效,
Access Token约 4 小时需 refresh,跨境店铺可能另有Merchant ID - Go Live 前在沙箱至少打通一条只读接口,再切生产
适用边界与注意点
本 skill 只交付数据入口,不含选品、利润测算、测品或投放等后续业务流程,也不代连第三方服务。身份类型提交后难以更改,动手前请确认是为自家店铺自用而申请;如用于服务多卖家,需要另行走 ISV 类路径,这份清单并不覆盖。
使用场景
- 店铺运营准备用官方 API 拉实时数据,避免爬虫,先申请 Seller In House 账号
- 自建系统需要连 Shopee 沙箱,先按清单准备 Test Partner ID/Key 并验证只读接口
- 对接中 sign 一直报错,需按技能核对 path、timestamp 和当前环境 key
- 要把跨境店铺接入自用系统,准备 Shop ID 并确认是否另有 Merchant ID
适合人员
- Shopee 店铺运营:要为自家店铺申请自用 API,替代爬虫获取实时数据
- 独立后端开发者:给单个店铺写自动化,需要按 Seller In House 类型接入开放平台
- 电商系统技术负责人:只负责自用数据入口,要区分沙箱与生产的 Partner Key 和 host
- 跨境电商管理员:准备 Shop ID 和可能的 Merchant ID,完成授权回调配置