一、接入前提（资质要求）
- 主体 ：必须是企业 / 个体工商户 （个人账号无法申请）
- 业务：跨境电商、跨境 ERP、独立站、跨境供应链服务相关
- 考核门槛（2026 新规）【GMV达不到可考虑接入第三方官方合作】
- 月成交额 ≥ 12 万元（通过寻源通 API 产生的确认订单）
- 调用效率 ≥ 0.5 元 / 次（总成交额 ÷ 总调用次数）
- 不达标会被限流 / 清退
二、完整接入流程（7 步）
1. 注册 1688 开放平台企业开发者
-
访问： open.1688.com
File
-
用企业 1688 账号 登录 → 注册为企业开发者
-
完成企业实名认证 ：
- 营业执照
- 法人身份证
- 企业对公账户验证
2. 创建应用 & 申请寻源通权限
- 控制台 → 应用管理 → 创建应用
- 应用名称：如「XX 跨境 ERP - 寻源通」
- 应用类型：企业应用 / 跨境电商类
- 应用场景：跨境选品 / 跨境供应链 / 跨境订单同步（必须写跨境相关）
- API 权限申请
- 进入 API 市场 → 跨境寻源通
- 勾选所需接口：
crossBorder.product.search（跨境商品搜索）crossBorder.product.get（商品详情）crossBorder.supplier.get（供应商资质）crossBorder.order.create（跨境订单创建）crossBorder.order.list（订单 / 物流）
- 提交审核（1--3 个工作日）
3. 获取密钥（appKey /appSecret）
审核通过后，在应用详情页获取：
appKey：应用 IDappSecret：签名密钥（严格保密）
4. 授权机制（获取 AccessToken）
寻源通采用 OAuth 2.0 授权
- 授权 URL（前端跳转）
plaintext
https://open.1688.com/auth/authorize.htm
?response_type=code
&client_id={appKey}
&redirect_uri={回调地址}
&state=自定义
&scope=crossBorder- 通过 code 换取 AccessToken（后端）
plaintext
POST https://open.1688.com/auth/token.htm
参数：
grant_type=authorization_code
client_id={appKey}
client_secret={appSecret}
code=上一步返回的code
redirect_uri={回调地址}- 返回：
access_token、refresh_token、有效期（通常7 天）
5. 接口签名规则（必看）
所有接口调用需签名（sign）
python
运行
# Python 示例
import hashlib
import time
def generate_sign(paramsapp_secret):
# 1. 按key排序
sorted_params = sorted(params.items())
# 2. 拼接字符串
concat_str = app_secret
for kv in sorted_params:
concat_str += f"{k}{v}"
concat_str += app_secret
# 3. MD5加密 → 大写
sign = hashlib.md5(concat_str.encode()).hexdigest().upper()
return sign
# 公共参数示例
timestamp = str(int(time.time() * 1000))
public_params = {
"app_key": "YOUR_APP_KEY",
"timestamp": timestamp,
"format": "on",
"v": "2.0",
"sign_method": "md5"
}6. 接口调用示例（跨境商品搜索）
python
运行
import requests
# 1. 构造请求参数
method = "crossBorder.product.search"
access_token = "YOUR_ACCESS_TOKEN"
biz_params = {
"keyword": "wireless earbuds",
"pageSize": 20,
"page": 1,
# 跨境筛选
"crossBorderType": "direct" # 支持跨境直发
"certification": "CE,FDA" # 合规认证
"targetMarket": "EU" # 目标市场
}
# 2. 合并参数 + 签名
all_params = {**public_params"method": method"access_token": access_token**biz_params}
all_params["sign"] = generate_sign(all_params"YOUR_APP_SECRET")
# 3. 发起请求
url = "https://open.1688.com/api/rest"
resp = requests.post(urldata=all_params)
result = resp.on()7. 测试 → 上线 → 运维
- 沙箱测试 ：开放平台提供测试环境验证流程
- 正式调用：审核通过 → 切换正式环境
- 监控 ：
- 调用量、成功率、耗时
- 每月考核指标（成交额、调用效率）
- 异常处理 ：
access_token过期自动刷新- 限流、降级、重试机制
三、核心接口清单（跨境专用）
- 商品寻源
crossBorder.product.search：跨境商品搜索（关键词、价格、销量、认证、市场）crossBorder.product.get：商品详情（SKU、库存、价格、跨境属性、认证）
- 供应商
crossBorder.supplier.get：供应商资质（是否工厂、诚信通、跨境能力）
- 订单 & 物流
crossBorder.order.create：创建跨境订单crossBorder.order.list：订单列表、状态、物流单号crossBorder.logistics.get：物流跟踪
四、常见问题
- 审核被拒
- 原因：场景描述不清、非跨境业务、资质不全
- 解决：明确写跨境电商 / ERP / 独立站 / 供应链用途
- 调用被限流
- 超过QPS 限制（默认 50 次 / 秒）
- 未达标月度考核（成交额 / 效率）
- 无数据 / 权限不足
- 未申请对应接口权限
access_token未带crossBorder范围
五、接入价值（跨境场景）
- ✅ 精准选品 ：一键筛选支持跨境、带 CE/FDA、适配目标市场的货源
- ✅ 自动同步：价格、库存、起订量实时同步到 ERP / 独立站
- ✅ 合规保障 ：官方接口，无风控 / 封号风险
- ✅ 跨境订单闭环：1688 下单 → 物流 → 售后全链路打通