背景
之前用淘宝开放平台直接调 CPS 转链 API，但用户 App Key 没有 general.link.parse、general.link.convert 等权限，这些接口是「定向开放」的，只有服务商（ISV）才能申请。
解决方案： 通过折淘客（zhetaoke.com）代理 API 转链。折淘客本质上是服务商，它帮你调淘宝/京东的 CPS 接口，你只需要一个 Appkey + 授权即可。
折淘客 API 架构
核心凭证
| 项 | 值 |
|---|---|
| 折淘客 Appkey | 折淘客/折京客通用 |
| 淘宝 SID | 代理类型授权 |
| 淘宝 PID | mm_xxx_xxx_xxx 三段格式 |
| 京东联盟 ID | 纯数字 |
API 端点
折淘客（淘宝/拼多多/苏宁等）端口 10001
├── 批量高佣转链: api.zhetaoke.com:10001/api/open_gaoyongzhuanlian_tkl_piliang.ashx
├── 订单查询: api.zhetaoke.com:10001/api/open_dingdanchaxun2.ashx
折京客（京东专属）端口 20000
├── 批量转链: api.zhetaoke.com:20000/api/open_gaoyongzhuanlian_tkl_piliang.ashx
├── 单条转链（含详情）: api.zhetaoke.com:20000/api/open_jing_union_open_promotion_byunionid_get.ashx
├── 订单查询: api.zhetaoke.com:20000/api/open_jing_union_openz_order_row_query.ashx
转链流程
用户粘贴文案（含链接/口令）
↓
正则提取所有链接和口令
↓
自动识别平台（京东/淘宝/拼多多/唯品会/苏宁）
↓
调用折淘客/折京客 API 批量转链
↓
替换原文中的链接为推广链接，其余内容不变
↓
输出完整文案 + 逐条转链结果
版本迭代
v3.0 — 引入折淘客代理
- 淘宝转链改走折淘客批量接口
- 京东转链改走折京客批量+单条接口
- 解决了淘宝 CPS 权限问题
v4.0 — 界面重构
- 全新配色方案，卡片式布局
- 右键菜单，剪贴板粘贴
v5.0 — 功能整合
- 双标签页：转链 + 订单查询
- 转链历史持久化（500条）
- 智能复制（可选商品名/平台/链接）
v5.1 — 整段文案转链
- 支持粘贴完整文案
- 自动提取文案中所有链接和口令
- 只替换链接，保留其余内容
v5.2 — 5 平台 + 订单查询
- 新增拼多多、苏宁联盟
- 订单查询 API 对接
- 返利统计
v5.3 — macOS 兼容修复
- 按钮背景色强制渲染
- 布局全部改 pack
踩坑记录
1. 淘宝 CPS 权限是「定向开放」
普通 App Key 拿不到 CPS 转链权限，只有 ISV 才有。必须走代理服务商。
2. 折淘客和折京客是两个系统
虽然账号通用，但 API 端口不同。折淘客（淘宝系）用端口 10001，折京客（京东系）用端口 20000。
3. 京东订单查询需要额外凭证
需要京东开放平台的 jd_app_key + jd_app_secret，不是折淘客的 appkey。
4. macOS tkinter 按钮渲染问题
macOS 上 tk.Button 设置 bg 蓝色 + fg 白色不生效，按钮显示为白底白字。解决：加 highlightbackground 和 relief="solid"。
5. 订单查询时间范围限制
淘宝最大 3 小时，京东最大 1 小时，超过会报错。
测试数据
淘宝转链
输入: /YQO45gQtqDv// AA11
商品: 参半酵素氨基酸牙膏美白牙齿80g
券后价: ¥16.2 | 佣金率: 11.7%
新口令: (fSPE5gOmbNQ)
京东转链
输入: https://u.jd.com/j125wOu
推广链接: https://u.jd.com/jaYlJc5
整段文案转链
输入：
参半牙膏120g两件9.9！
①领券https://u.jd.com/j125wOu
②下单https://u.jd.com/jDnQAoG
淘宝口令👇/YQO45gQtqDv// AA11
输出：
参半牙膏120g两件9.9！
①领券https://u.jd.com/jaYlJc5
②下单https://u.jd.com/j6YN9j2
淘宝口令👇(fSPE5gOmbNQ)
最终功能
| 功能 | 说明 |
|---|---|
| 5 平台转链 | 京东/淘宝/拼多多/唯品会/苏宁 |
| 整段文案转链 | 粘贴完整文案，自动提取并替换链接 |
| 自动识别平台 | 根据链接特征自动判断 |
| 转链历史 | 最近 300 条，右键复制 |
| 订单查询 | 淘宝/京东订单，带统计 |
| 多账号管理 | 每平台独立配置 |
| CSV 导出 | 结果导出 |
总代码量： 约 1,230 行 Python
技术栈： Python 3 + tkinter + 折淘客/折京客 API